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

package/lib/view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewState.d.ts

@@ -0,0 +1,57 @@
+import { FetchedState, ID } from '../../../commonStateTypes/common';
+import { InvoicingCatalogItemKind } from '../invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewState';
+/** A single pricing tier within a sub-family (values kept as raw strings). */
+export interface InvoicingCatalogItemFormTier {
+    endingUnit: string;
+    packageSize: string;
+    price: string;
+    pricingType: string;
+    startingUnit: string;
+}
+/** A sub-family (price point) of a catalog item. */
+export interface InvoicingCatalogItemFormSubFamily {
+    billingCycles: string;
+    description: string;
+    externalName: string;
+    freeQuantity: string;
+    isTaxable: boolean;
+    period: string;
+    periodUnit: string;
+    priceDollars: string;
+    pricingModel: string;
+    prorationType: string;
+    showDescriptionInInvoices: boolean;
+    showDescriptionInQuotes: boolean;
+    tiers: InvoicingCatalogItemFormTier[];
+    trialEndAction: string;
+    trialPeriod: string;
+    trialPeriodUnit: string;
+}
+/**
+ * Draft form state for the create/edit catalog item (plan / add-on / one-time
+ * charge) form. Held in CES so the form flows its data from here (mirrors the
+ * customer form pattern). `catalogType` is `plan` | `addon` | `charge`; the
+ * backend `kind` (plan vs product) is derived from it in the save epic.
+ */
+export interface InvoicingCatalogItemFormLocalData {
+    accountingCategory: string;
+    accountingCode: string;
+    applicableItems: string[];
+    catalogType: string;
+    description: string;
+    externalName: string;
+    invoiceName: string;
+    invoiceNotes: string;
+    itemApplicability: string;
+    itemId: string;
+    name: string;
+    sku: string;
+    subFamilies: InvoicingCatalogItemFormSubFamily[];
+    unit: string;
+}
+export interface EditInvoicingCatalogItemDetailViewState extends FetchedState {
+    editDraftById: Record<ID, InvoicingCatalogItemFormLocalData>;
+    newItemDraft: InvoicingCatalogItemFormLocalData;
+    savedItemId?: ID;
+    savedKind?: InvoicingCatalogItemKind;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/editInvoicingCatalogItemDetailView/invoicingCatalogItemFormConfig.d.ts

@@ -0,0 +1,32 @@
+import { InvoicingCatalogItemKind } from '../invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewState';
+import { InvoicingCatalogItemFormLocalData, InvoicingCatalogItemFormSubFamily, InvoicingCatalogItemFormTier } from './editInvoicingCatalogItemDetailViewState';
+/**
+ * Canonical value sets for the catalog item form. CES owns the values;
+ * web-components maps each value to a localized label.
+ */
+export declare const INVOICING_CATALOG_TYPE_VALUES: readonly ["plan", "addon", "charge"];
+export declare const INVOICING_CATALOG_PERIOD_UNIT_VALUES: readonly ["day", "week", "month", "year"];
+export declare const INVOICING_CATALOG_PRICING_MODEL_VALUES: readonly ["flat_fee", "per_unit", "tiered", "volume", "stairstep"];
+export declare const INVOICING_CATALOG_TIER_TYPE_VALUES: readonly ["per_unit", "flat_fee", "package"];
+export declare const INVOICING_CATALOG_TRIAL_UNIT_VALUES: readonly ["day", "month"];
+export declare const INVOICING_CATALOG_TRIAL_END_ACTION_VALUES: readonly ["site_default", "activate_subscription", "cancel_subscription"];
+export declare const INVOICING_CATALOG_PRORATION_VALUES: readonly ["site_default", "partial_term", "full_term"];
+export declare const INVOICING_CATALOG_APPLICABILITY_VALUES: readonly ["all", "restricted"];
+export declare const isTieredCatalogPricingModel: (model: string) => boolean;
+export declare const blankInvoicingCatalogTier: (startingUnit?: string) => InvoicingCatalogItemFormTier;
+export declare const blankInvoicingCatalogSubFamily: () => InvoicingCatalogItemFormSubFamily;
+export declare const initialInvoicingCatalogItemFormLocalData: InvoicingCatalogItemFormLocalData;
+/**
+ * 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 declare const entityToInvoicingCatalogItemFormLocalData: (item?: {
+    applicableItems?: string[];
+    description?: string;
+    externalName?: string;
+    id?: string;
+    itemApplicability?: string;
+    name?: string;
+    unit?: string;
+}, kind?: InvoicingCatalogItemKind) => InvoicingCatalogItemFormLocalData;

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

@@ -0,0 +1,159 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.entityToInvoicingCatalogItemFormLocalData = exports.initialInvoicingCatalogItemFormLocalData = exports.blankInvoicingCatalogSubFamily = exports.blankInvoicingCatalogTier = exports.isTieredCatalogPricingModel = exports.INVOICING_CATALOG_APPLICABILITY_VALUES = exports.INVOICING_CATALOG_PRORATION_VALUES = exports.INVOICING_CATALOG_TRIAL_END_ACTION_VALUES = exports.INVOICING_CATALOG_TRIAL_UNIT_VALUES = exports.INVOICING_CATALOG_TIER_TYPE_VALUES = exports.INVOICING_CATALOG_PRICING_MODEL_VALUES = exports.INVOICING_CATALOG_PERIOD_UNIT_VALUES = exports.INVOICING_CATALOG_TYPE_VALUES = void 0;
+/**
+ * Canonical value sets for the catalog item form. CES owns the values;
+ * web-components maps each value to a localized label.
+ */
+exports.INVOICING_CATALOG_TYPE_VALUES = [
+    'plan',
+    'addon',
+    'charge',
+];
+exports.INVOICING_CATALOG_PERIOD_UNIT_VALUES = [
+    'day',
+    'week',
+    'month',
+    'year',
+];
+exports.INVOICING_CATALOG_PRICING_MODEL_VALUES = [
+    'flat_fee',
+    'per_unit',
+    'tiered',
+    'volume',
+    'stairstep',
+];
+exports.INVOICING_CATALOG_TIER_TYPE_VALUES = [
+    'per_unit',
+    'flat_fee',
+    'package',
+];
+exports.INVOICING_CATALOG_TRIAL_UNIT_VALUES = ['day', 'month'];
+exports.INVOICING_CATALOG_TRIAL_END_ACTION_VALUES = [
+    'site_default',
+    'activate_subscription',
+    'cancel_subscription',
+];
+exports.INVOICING_CATALOG_PRORATION_VALUES = [
+    'site_default',
+    'partial_term',
+    'full_term',
+];
+exports.INVOICING_CATALOG_APPLICABILITY_VALUES = [
+    'all',
+    'restricted',
+];
+const isTieredCatalogPricingModel = (model) => ['tiered', 'volume', 'stairstep'].includes(model);
+exports.isTieredCatalogPricingModel = isTieredCatalogPricingModel;
+const blankInvoicingCatalogTier = (startingUnit = '1') => ({
+    endingUnit: '',
+    packageSize: '',
+    price: '',
+    pricingType: 'per_unit',
+    startingUnit,
+});
+exports.blankInvoicingCatalogTier = blankInvoicingCatalogTier;
+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: [(0, exports.blankInvoicingCatalogTier)('1')],
+    trialEndAction: 'site_default',
+    trialPeriod: '',
+    trialPeriodUnit: 'month',
+});
+exports.blankInvoicingCatalogSubFamily = blankInvoicingCatalogSubFamily;
+const subFamilyFromProduct = (product) => {
+    const base = (0, exports.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),
+            }))
+            : [(0, exports.blankInvoicingCatalogTier)('1')],
+        trialEndAction: product.trialEndAction ?? 'site_default',
+        trialPeriod: product.trialPeriod != null ? String(product.trialPeriod) : '',
+        trialPeriodUnit: product.trialPeriodUnit ?? 'month',
+    };
+};
+exports.initialInvoicingCatalogItemFormLocalData = {
+    accountingCategory: '',
+    accountingCode: '',
+    applicableItems: [],
+    catalogType: 'plan',
+    description: '',
+    externalName: '',
+    invoiceName: '',
+    invoiceNotes: '',
+    itemApplicability: 'all',
+    itemId: '',
+    name: '',
+    sku: '',
+    subFamilies: [(0, exports.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.
+ */
+const entityToInvoicingCatalogItemFormLocalData = (item, kind) => {
+    if (item == null) {
+        return {
+            ...exports.initialInvoicingCatalogItemFormLocalData,
+            subFamilies: [(0, exports.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 ?? '',
+    };
+};
+exports.entityToInvoicingCatalogItemFormLocalData = entityToInvoicingCatalogItemFormLocalData;

package/lib/view/invoicing/editInvoicingCatalogItemDetailView/saveInvoicingCatalogItemEpic.d.ts

@@ -0,0 +1,9 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { updateInvoicingPlans } from '../../../entity/invoicing/plan/planReducer';
+import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { saveInvoicingCatalogItem, submitInvoicingCatalogItemForm, submitInvoicingCatalogItemFormFailure, submitInvoicingCatalogItemFormSuccess } from './editInvoicingCatalogItemDetailViewReducer';
+export type ActionType = ReturnType<typeof submitInvoicingCatalogItemForm> | ReturnType<typeof saveInvoicingCatalogItem> | ReturnType<typeof submitInvoicingCatalogItemFormSuccess> | ReturnType<typeof submitInvoicingCatalogItemFormFailure> | ReturnType<typeof updateInvoicingPlans> | ReturnType<typeof updateInvoicingProducts>;
+export declare const saveInvoicingCatalogItemEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveInvoicingCatalogItemEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const planReducer_1 = require("../../../entity/invoicing/plan/planReducer");
+const productReducer_1 = require("../../../entity/invoicing/product/productReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const editInvoicingCatalogItemDetailViewPayload_1 = require("./editInvoicingCatalogItemDetailViewPayload");
+const editInvoicingCatalogItemDetailViewReducer_1 = require("./editInvoicingCatalogItemDetailViewReducer");
+const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)((action) => editInvoicingCatalogItemDetailViewReducer_1.submitInvoicingCatalogItemForm.match(action) ||
+    editInvoicingCatalogItemDetailViewReducer_1.saveInvoicingCatalogItem.match(action)), (0, operators_1.mergeMap)((action) => {
+    const { id } = action.payload;
+    // Draft-based create/edit form vs. detail-page inline edit (raw data).
+    let kind;
+    let data;
+    if (editInvoicingCatalogItemDetailViewReducer_1.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 = (0, editInvoicingCatalogItemDetailViewPayload_1.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((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) && response.data != null) {
+            const entityAction = kind === 'plan'
+                ? (0, planReducer_1.updateInvoicingPlans)([response.data], 'merge')
+                : (0, productReducer_1.updateInvoicingProducts)([response.data], 'merge');
+            return [
+                entityAction,
+                (0, editInvoicingCatalogItemDetailViewReducer_1.submitInvoicingCatalogItemFormSuccess)({
+                    itemId: response.data.id,
+                    kind,
+                }),
+            ];
+        }
+        return (0, rxjs_1.of)((0, editInvoicingCatalogItemDetailViewReducer_1.submitInvoicingCatalogItemFormFailure)(response.status));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, editInvoicingCatalogItemDetailViewReducer_1.submitInvoicingCatalogItemFormFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save catalog item REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+exports.saveInvoicingCatalogItemEpic = saveInvoicingCatalogItemEpic;

package/lib/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewPayload.d.ts

@@ -0,0 +1,10 @@
+import { InvoicingCouponPayload } from '../../../entity/invoicing/coupon/couponPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+import { InvoicingCouponFormLocalData } from './editInvoicingCouponDetailViewState';
+export type InvoicingCouponWriteResponse = ZeniAPIResponse<InvoicingCouponPayload>;
+/**
+ * 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 declare const localDataToSaveInvoicingCouponPayload: (localData: InvoicingCouponFormLocalData, isCreate: boolean) => Record<string, unknown>;

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

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localDataToSaveInvoicingCouponPayload = void 0;
+/**
+ * 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.
+ */
+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;
+};
+exports.localDataToSaveInvoicingCouponPayload = localDataToSaveInvoicingCouponPayload;

package/lib/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewReducer.d.ts

@@ -0,0 +1,27 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ZeniAPIStatus } from '../../../responsePayload';
+import { EditInvoicingCouponDetailViewState, InvoicingCouponFormLocalData } from './editInvoicingCouponDetailViewState';
+/** Push the full form draft into CES (edit tree when `id` is present). */
+export interface UpdateInvoicingCouponFormDraftPayload {
+    localData: InvoicingCouponFormLocalData;
+    id?: ID;
+}
+/** Trigger create (no id) / update (with id) from the stored draft. */
+export interface SubmitInvoicingCouponFormPayload {
+    id?: ID;
+}
+/**
+ * Data-based save used by the discount detail-page inline edit (which builds its
+ * own payload). The create/edit form flow uses the draft-based
+ * `submitInvoicingCouponForm` instead.
+ */
+export interface SaveInvoicingCouponPayload {
+    data: Record<string, unknown>;
+    id?: ID;
+}
+export declare const initialState: EditInvoicingCouponDetailViewState;
+export declare const updateInvoicingCouponFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<UpdateInvoicingCouponFormDraftPayload, "editInvoicingCouponDetailView/updateInvoicingCouponFormDraft">, submitInvoicingCouponForm: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: SubmitInvoicingCouponFormPayload], SubmitInvoicingCouponFormPayload, "editInvoicingCouponDetailView/submitInvoicingCouponForm", never, never>, saveInvoicingCoupon: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[payload: SaveInvoicingCouponPayload], SaveInvoicingCouponPayload, "editInvoicingCouponDetailView/saveInvoicingCoupon", never, never>, submitInvoicingCouponFormSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    couponId: ID;
+}, "editInvoicingCouponDetailView/submitInvoicingCouponFormSuccess">, submitInvoicingCouponFormFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "editInvoicingCouponDetailView/submitInvoicingCouponFormFailure">, resetEditInvoicingCouponDetailView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"editInvoicingCouponDetailView/resetEditInvoicingCouponDetailView">;
+declare const _default: import("redux").Reducer<EditInvoicingCouponDetailViewState>;
+export default _default;

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

@@ -0,0 +1,69 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resetEditInvoicingCouponDetailView = exports.submitInvoicingCouponFormFailure = exports.submitInvoicingCouponFormSuccess = exports.saveInvoicingCoupon = exports.submitInvoicingCouponForm = exports.updateInvoicingCouponFormDraft = exports.initialState = void 0;
+const toolkit_1 = require("@reduxjs/toolkit");
+const invoicingCouponFormConfig_1 = require("./invoicingCouponFormConfig");
+exports.initialState = {
+    fetchState: 'Not-Started',
+    error: undefined,
+    editDraftById: {},
+    newCouponDraft: { ...invoicingCouponFormConfig_1.initialInvoicingCouponFormLocalData },
+    savedCouponId: undefined,
+    hasValidState() {
+        return this.fetchState === 'Completed';
+    },
+};
+const editInvoicingCouponDetailView = (0, toolkit_1.createSlice)({
+    name: 'editInvoicingCouponDetailView',
+    initialState: exports.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 = { ...invoicingCouponFormConfig_1.initialInvoicingCouponFormLocalData };
+        },
+    },
+});
+_a = editInvoicingCouponDetailView.actions, exports.updateInvoicingCouponFormDraft = _a.updateInvoicingCouponFormDraft, exports.submitInvoicingCouponForm = _a.submitInvoicingCouponForm, exports.saveInvoicingCoupon = _a.saveInvoicingCoupon, exports.submitInvoicingCouponFormSuccess = _a.submitInvoicingCouponFormSuccess, exports.submitInvoicingCouponFormFailure = _a.submitInvoicingCouponFormFailure, exports.resetEditInvoicingCouponDetailView = _a.resetEditInvoicingCouponDetailView;
+exports.default = editInvoicingCouponDetailView.reducer;

package/lib/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewSelector.d.ts

@@ -0,0 +1,32 @@
+import { ID } from '../../../commonStateTypes/common';
+import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
+import { InvoicingCouponApplyOn, InvoicingCouponDurationType, InvoicingCouponPeriodUnit, InvoicingDiscountType } from '../../../entity/invoicing/coupon/couponPayload';
+import { InvoicingCoupon } from '../../../entity/invoicing/coupon/couponState';
+import { InvoicingFormOption } from '../../../entity/invoicing/invoicingCommonPayload';
+import { RootState } from '../../../reducer';
+import { InvoicingCouponFormLocalData } from './editInvoicingCouponDetailViewState';
+export interface EditInvoicingCouponDetailView extends SelectorView {
+    coupon?: InvoicingCoupon;
+    savedCouponId?: ID;
+}
+/**
+ * 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 declare const getEditInvoicingCouponDetailViewState: (state: RootState, couponId?: ID) => EditInvoicingCouponDetailView;
+export interface InvoicingCouponFormView extends EditInvoicingCouponDetailView {
+    applyOnOptions: readonly InvoicingFormOption<InvoicingCouponApplyOn>[];
+    discountTypeOptions: readonly InvoicingFormOption<InvoicingDiscountType>[];
+    durationTypeOptions: readonly InvoicingFormOption<InvoicingCouponDurationType>[];
+    localData: InvoicingCouponFormLocalData;
+    mode: 'create' | 'edit';
+    periodUnitOptions: readonly InvoicingFormOption<InvoicingCouponPeriodUnit>[];
+}
+/**
+ * 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 declare const getInvoicingCouponFormView: (state: RootState, couponId?: ID) => InvoicingCouponFormView;

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

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getInvoicingCouponFormView = exports.getEditInvoicingCouponDetailViewState = void 0;
+const couponConstants_1 = require("../../../entity/invoicing/coupon/couponConstants");
+const couponSelector_1 = require("../../../entity/invoicing/coupon/couponSelector");
+const invoicingCouponFormConfig_1 = require("./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.
+ */
+const getEditInvoicingCouponDetailViewState = (state, couponId) => {
+    const { error, fetchState, savedCouponId } = state.editInvoicingCouponDetailViewState;
+    return {
+        coupon: couponId != null ? (0, couponSelector_1.getInvoicingCouponById)(state, couponId) : undefined,
+        savedCouponId,
+        fetchState,
+        error,
+        version: 1.0,
+    };
+};
+exports.getEditInvoicingCouponDetailViewState = getEditInvoicingCouponDetailViewState;
+/**
+ * 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.
+ */
+const getInvoicingCouponFormView = (state, couponId) => {
+    const base = (0, exports.getEditInvoicingCouponDetailViewState)(state, couponId);
+    const { editDraftById, newCouponDraft } = state.editInvoicingCouponDetailViewState;
+    const localData = couponId != null
+        ? (editDraftById[couponId] ??
+            (0, invoicingCouponFormConfig_1.entityToInvoicingCouponFormLocalData)(base.coupon))
+        : newCouponDraft;
+    return {
+        ...base,
+        applyOnOptions: couponConstants_1.INVOICING_COUPON_APPLY_ON_OPTIONS,
+        discountTypeOptions: couponConstants_1.INVOICING_DISCOUNT_TYPE_OPTIONS,
+        durationTypeOptions: couponConstants_1.INVOICING_COUPON_DURATION_TYPE_OPTIONS,
+        localData,
+        mode: couponId != null ? 'edit' : 'create',
+        periodUnitOptions: couponConstants_1.INVOICING_COUPON_PERIOD_UNIT_OPTIONS,
+    };
+};
+exports.getInvoicingCouponFormView = getInvoicingCouponFormView;

package/lib/view/invoicing/editInvoicingCouponDetailView/editInvoicingCouponDetailViewState.d.ts

@@ -0,0 +1,29 @@
+import { FetchedState, ID } from '../../../commonStateTypes/common';
+/**
+ * Draft form state for the create/edit discount-coupon form. Held in CES so the
+ * form flows its data from here (mirrors the customer form pattern). Dates are
+ * stored as ISO `YYYY-MM-DD` strings; amounts/quantities as raw strings.
+ */
+export interface InvoicingCouponFormLocalData {
+    applyOn: string;
+    couponCode: string;
+    couponId: string;
+    discountAmount: string;
+    discountPercentage: string;
+    discountQuantity: string;
+    discountType: string;
+    durationType: string;
+    invoiceName: string;
+    invoiceNotes: string;
+    maxRedemptions: string;
+    name: string;
+    period: string;
+    periodUnit: string;
+    validFrom: string;
+    validTill: string;
+}
+export interface EditInvoicingCouponDetailViewState extends FetchedState {
+    editDraftById: Record<ID, InvoicingCouponFormLocalData>;
+    newCouponDraft: InvoicingCouponFormLocalData;
+    savedCouponId?: ID;
+}

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

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/view/invoicing/editInvoicingCouponDetailView/invoicingCouponFormConfig.d.ts

@@ -0,0 +1,5 @@
+import { InvoicingCoupon } from '../../../entity/invoicing/coupon/couponState';
+import { InvoicingCouponFormLocalData } from './editInvoicingCouponDetailViewState';
+export declare const initialInvoicingCouponFormLocalData: InvoicingCouponFormLocalData;
+/** Seed the form draft from an existing coupon entity (edit mode). */
+export declare const entityToInvoicingCouponFormLocalData: (coupon?: InvoicingCoupon) => InvoicingCouponFormLocalData;