@zeniai/client-epic-state 5.2.59 → 5.2.60

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

@@ -56,6 +56,98 @@ const isShippingAddressUnsaved = (state, id, savedShippingAddressId) => {
         pending.country === saved.country &&
         (pending.countryCode ?? '') === (saved.countryCode ?? ''));
 };
+/**
+ * The add-ons / one-time charges a plan actually accepts.
+ *
+ * A catalog item is either `restricted` — it names the item ids it may be
+ * subscribed alongside in `applicableItems` — or unrestricted, in which case
+ * every item is fair game. Matching is on `itemID` (the catalog item the price
+ * row was flattened from), not the price code, because applicability is
+ * declared item-to-item.
+ *
+ * Fails open where the rule is unknown: no plan selected yet, a plan that is
+ * not `restricted`, or a `restricted` plan whose allow-list never came down all
+ * return the full list. The create/update endpoint rejects a disallowed item
+ * with a 422 regardless, so offering one too many costs a server error the user
+ * already gets today, where hiding one too few makes a legitimate add-on
+ * unreachable with nothing on screen to explain why.
+ *
+ * An allow-list that arrived *empty* is not unknown — a restricted item is
+ * saved with `applicable_items: []` when nothing was picked — so that narrows
+ * to nothing, as the server does.
+ *
+ * Lives here rather than in a screen so the create/edit form and the detail
+ * page's inline edit narrow their pickers by the same rule.
+ */
+export const getInvoicingItemsAllowedForPlan = (products, plan) => {
+    const allowedItemIDs = plan?.applicableItems;
+    if (plan?.itemApplicability !== 'restricted' || allowedItemIDs == null) {
+        return products;
+    }
+    return products.filter((product) => product.itemID != null && allowedItemIDs.includes(product.itemID));
+};
+/**
+ * A price row can only be subscribed by its price code, so one without a code
+ * is not an option the form can offer.
+ */
+const hasInvoicingPriceCode = (product) => product.priceCode != null && product.priceCode.trim() !== '';
+/**
+ * `displayPrice` is the service-computed single-unit amount. Tiered, volume and
+ * stairstep price points store `price` as `0` because the money lives in their
+ * tiers, so `price` is only a fallback for responses predating `displayPrice`.
+ */
+const invoicingUnitPrice = (product) => product.displayPrice ?? product.price;
+const toInvoicingPlanOption = (plan) => ({
+    billingCycles: plan.billingCycles,
+    // The price point's own cadence: the backend derives billing period from the
+    // price point and rejects a subscription that claims a different one.
+    billingPeriod: plan.period,
+    billingPeriodUnit: plan.periodUnit,
+    label: plan.name ?? plan.id,
+    price: invoicingUnitPrice(plan),
+    productCode: plan.productCode,
+    trialPeriod: plan.trialPeriod,
+    trialPeriodUnit: plan.trialPeriodUnit,
+    value: plan.priceCode,
+});
+const toInvoicingCatalogItemOption = (product) => ({
+    // A one-time charge has no cadence, so its price is quoted flat rather than
+    // per period.
+    billingPeriodUnit: product.itemType === 'charge' ? undefined : product.periodUnit,
+    label: product.name ?? product.id,
+    price: invoicingUnitPrice(product),
+    productCode: product.productCode,
+    value: product.priceCode,
+});
+const toInvoicingCouponOption = (coupon) => ({
+    label: coupon.name ?? coupon.couponCode ?? coupon.id,
+    // Create/apply/remove coupon APIs resolve by coupon_code.
+    value: coupon.couponCode ?? coupon.id,
+});
+/**
+ * Company first, then the person's name, then the email — whichever the
+ * customer actually has. The id is the last resort so a record with no
+ * identifying field at all is still selectable rather than a blank row.
+ */
+const invoicingCustomerDisplayName = (customer) => {
+    const fullName = [customer.firstName, customer.lastName]
+        .filter((part) => part != null && part.trim() !== '')
+        .join(' ')
+        .trim();
+    const company = customer.company?.trim() ?? '';
+    const email = customer.email?.trim() ?? '';
+    return company !== ''
+        ? company
+        : fullName !== ''
+            ? fullName
+            : email !== ''
+                ? email
+                : customer.id;
+};
+const toInvoicingCustomerOption = (customer) => ({
+    label: invoicingCustomerDisplayName(customer),
+    value: customer.id,
+});
 export const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
     const { editDraftById, error, fetchState, newSubscriptionDraft, savedSubscriptionId, } = state.editInvoicingSubscriptionDetailViewState;
     const mode = invoicingSubscriptionID != null ? 'edit' : 'create';
@@ -77,8 +169,15 @@ export const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID)
         : undefined;
     const hasUnsavedShippingAddress = isShippingAddressUnsaved(state, invoicingSubscriptionID, subscription?.shippingAddressId);
     const catalogListView = getInvoicingCatalogListView(state);
-    const planPrices = getInvoicingCatalogPrices(catalogListView.plans);
-    const addonAndChargePrices = getInvoicingCatalogPrices(catalogListView.products);
+    const planPrices = getInvoicingCatalogPrices(catalogListView.plans).filter(hasInvoicingPriceCode);
+    // A restricted plan names the catalog items it may be sold with, so the
+    // pickers offer only those: subscription create rejects the rest with a 422,
+    // and an option that can only fail is not a choice. The applicability rides
+    // on the price rows already in the store, so this is a join, not a refetch.
+    const allowedCatalogPrices = getInvoicingItemsAllowedForPlan(getInvoicingCatalogPrices(catalogListView.products), planPrices.find((plan) => plan.priceCode === localData.planPriceCode)).filter(hasInvoicingPriceCode);
+    const catalogItemOptionsOfType = (itemType) => allowedCatalogPrices
+        .filter((product) => product.itemType === itemType)
+        .map(toInvoicingCatalogItemOption);
     // In create mode there is nothing to load, so the record state only applies
     // when editing an existing subscription.
     const recordState = invoicingSubscriptionID != null
@@ -100,12 +199,13 @@ export const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID)
         recordState,
         isFormLoading: isInvoicingFormDraftPending(editDraftById, invoicingSubscriptionID),
         fieldHelp: invoicingFieldHelpForGroup(state, 'subscription'),
-        coupons: getInvoicingCouponListItems(state),
-        customers: getInvoicingCustomerListView(state).customers,
+        addons: catalogItemOptionsOfType('addon'),
+        charges: catalogItemOptionsOfType('charge'),
+        coupons: getInvoicingCouponListItems(state).map(toInvoicingCouponOption),
+        customers: getInvoicingCustomerListView(state).customers.map(toInvoicingCustomerOption),
         localData,
         mode,
-        plans: planPrices,
-        products: addonAndChargePrices,
+        plans: planPrices.map(toInvoicingPlanOption),
         savedSubscriptionId,
         shippingAddressLabel,
         hasUnsavedShippingAddress,

package/lib/esm/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewSelector.js

@@ -2,8 +2,20 @@ import { createSelector } from '@reduxjs/toolkit';
 import { getInvoicingPlansByIds } from '../../../entity/invoicing/plan/planSelector';
 import { runningInvoicingActionId } from '../runningInvoicingActionId';
 import { INVOICING_PRODUCT_COLUMNS, } from './invoicingCatalogListViewState';
+/**
+ * Flatten catalog items into the price rows the pickers render.
+ *
+ * The parent item's `applicableItems` / `itemApplicability` are carried onto
+ * every row it produces: applicability is a property of the catalog item, not
+ * of its price points, and a row that has lost it cannot be matched against the
+ * selected plan's allow-list (see `getInvoicingItemsAllowedForPlan`). Both are
+ * written after the spread so the item's own rule wins over any stale copy a
+ * price point payload may carry.
+ */
 export const getInvoicingCatalogPrices = (items) => items.flatMap((item) => (item.subFamilies ?? []).map((subFamily) => ({
     ...subFamily,
+    applicableItems: item.applicableItems,
+    itemApplicability: item.itemApplicability,
     itemID: item.id,
     itemType: item.type ?? item.itemType,
     name: subFamily.name,

package/lib/index.d.ts

@@ -1132,7 +1132,7 @@ export type { SubmitInvoicingSubscriptionFormPayload, UpdateInvoicingSubscriptio
 export type { InvoicingSubscriptionFormLocalData } from './view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewState';
 export { INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE, entityToInvoicingSubscriptionFormLocalData, initialInvoicingSubscriptionFormLocalData, invoicingSubscriptionTodayIso, toInvoicingSubscriptionQuantity, } from './view/invoicing/editInvoicingSubscriptionDetailView/invoicingSubscriptionFormConfig';
 export { getEditInvoicingSubscriptionDetailViewState, getInvoicingSubscriptionFormView, } from './view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewSelector';
-export type { EditInvoicingSubscriptionDetailView, InvoicingSubscriptionFormView, } from './view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewSelector';
+export type { EditInvoicingSubscriptionDetailView, InvoicingSubscriptionFormView, InvoicingSubscriptionOption, } from './view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewSelector';
 export { resetEditInvoicingCatalogItemDetailView, submitInvoicingCatalogItemForm, updateInvoicingCatalogItemFormDraft, } from './view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewReducer';
 export type { SubmitInvoicingCatalogItemFormPayload, UpdateInvoicingCatalogItemFormDraftPayload, } from './view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewReducer';
 export type { InvoicingCatalogAccountingLookup } from './view/invoicing/editInvoicingCatalogItemDetailView/editInvoicingCatalogItemDetailViewPayload';

package/lib/view/invoicing/editInvoicingSubscriptionDetailView/editInvoicingSubscriptionDetailViewSelector.d.ts

@@ -1,8 +1,7 @@
+import { Amount } from '../../../commonStateTypes/amount';
 import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
-import { InvoicingCoupon } from '../../../entity/invoicing/coupon/couponState';
 import { InvoicingFieldHelpByCode, InvoicingNamedOption, InvoicingSubscriptionLifecycleActionOption } from '../../../entity/invoicing/invoicingCommonPayload';
-import { InvoicingCustomer } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerState';
 import { InvoicingSubscription } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionState';
 import { InvoicingProduct } from '../../../entity/invoicing/product/productState';
 import { RootState } from '../../../rootStateTypes';
@@ -25,21 +24,25 @@ export interface EditInvoicingSubscriptionDetailView extends SelectorView {
  * The full data the subscription form screen needs in one selector: the draft
  * `localData` (seeded from the existing subscription in edit mode until the user
  * edits), the shipping-address label (from the shared Address screen), the
- * canonical billing-frequency value set, the raw option lists (customers, plans,
- * products, coupons), and the save state. The screen maps the raw lists/values
- * to its own option shapes, so this stays free of any web-components dependency.
+ * canonical billing-frequency value set, the picker option lists (customers,
+ * plans, add-ons, charges, coupons) and the save state. The options are plain
+ * `{label, value}` records, so this stays free of any web-components
+ * dependency while leaving the screen nothing to derive.
  */
 export interface InvoicingSubscriptionFormView extends SelectorView {
     /** Lifecycle action in flight, folded in from the record view. */
     actionState: FetchStateAndError;
-    /** Cancel reasons from `/1.0/config`, so the dialog hardcodes nothing. */
-    cancelReasonCodeOptions: InvoicingNamedOption[];
-    coupons: InvoicingCoupon[];
-    customers: InvoicingCustomer[];
     /**
-     * Backend help copy for this screen's field group, keyed by field code.
-     * Folded in here so the screen never reaches for the config view itself.
+     * Picker options, built here rather than by each screen so the create form
+     * and the detail page's inline edit cannot drift. `addons` and `charges` are
+     * already narrowed to what the selected plan allows.
      */
+    addons: InvoicingSubscriptionOption[];
+    /** Cancel reasons from `/1.0/config`, so the dialog hardcodes nothing. */
+    cancelReasonCodeOptions: InvoicingNamedOption[];
+    charges: InvoicingSubscriptionOption[];
+    coupons: InvoicingSubscriptionOption[];
+    customers: InvoicingSubscriptionOption[];
     fieldHelp: InvoicingFieldHelpByCode;
     /**
      * True while the subscription being edited is still on its way to the form.
@@ -63,8 +66,7 @@ export interface InvoicingSubscriptionFormView extends SelectorView {
      * real values.
      */
     pageFetchState: FetchStateAndError;
-    plans: InvoicingProduct[];
-    products: InvoicingProduct[];
+    plans: InvoicingSubscriptionOption[];
     recordState: FetchStateAndError;
     /** Config-owned edit/lifecycle rules, folded in so the screen reads one selector. */
     subscriptionCommercialEditAllowedFromStatuses: string[];
@@ -82,4 +84,53 @@ export interface InvoicingSubscriptionFormView extends SelectorView {
     subscription?: InvoicingSubscription;
 }
 export declare const getEditInvoicingSubscriptionDetailViewState: (state: RootState, invoicingSubscriptionID?: ID) => EditInvoicingSubscriptionDetailView;
+/**
+ * The add-ons / one-time charges a plan actually accepts.
+ *
+ * A catalog item is either `restricted` — it names the item ids it may be
+ * subscribed alongside in `applicableItems` — or unrestricted, in which case
+ * every item is fair game. Matching is on `itemID` (the catalog item the price
+ * row was flattened from), not the price code, because applicability is
+ * declared item-to-item.
+ *
+ * Fails open where the rule is unknown: no plan selected yet, a plan that is
+ * not `restricted`, or a `restricted` plan whose allow-list never came down all
+ * return the full list. The create/update endpoint rejects a disallowed item
+ * with a 422 regardless, so offering one too many costs a server error the user
+ * already gets today, where hiding one too few makes a legitimate add-on
+ * unreachable with nothing on screen to explain why.
+ *
+ * An allow-list that arrived *empty* is not unknown — a restricted item is
+ * saved with `applicable_items: []` when nothing was picked — so that narrows
+ * to nothing, as the server does.
+ *
+ * Lives here rather than in a screen so the create/edit form and the detail
+ * page's inline edit narrow their pickers by the same rule.
+ */
+export declare const getInvoicingItemsAllowedForPlan: (products: InvoicingProduct[], plan: InvoicingProduct | undefined) => InvoicingProduct[];
+/**
+ * One entry in a subscription-form picker, ready for the screen to render.
+ *
+ * `label` and `value` are the whole contract for a coupon or a customer. A
+ * catalog item adds the pieces its subtitle is built from — `productCode`,
+ * `price`, `billingPeriodUnit` — rather than a finished string, because
+ * formatting money is the UI's job: CES holds {@link Amount} as data and has
+ * no currency formatter. `subtitle` is the escape hatch for a caller that
+ * already has the line it wants.
+ *
+ * A plan carries the extra fields the form prefills from it: its paid-cycle
+ * limit, its cadence, and its trial length.
+ */
+export interface InvoicingSubscriptionOption {
+    label: string;
+    value: string;
+    billingCycles?: number;
+    billingPeriod?: number;
+    billingPeriodUnit?: string;
+    price?: Amount;
+    productCode?: string;
+    subtitle?: string;
+    trialPeriod?: number;
+    trialPeriodUnit?: string;
+}
 export declare const getInvoicingSubscriptionFormView: (state: RootState, invoicingSubscriptionID?: ID) => InvoicingSubscriptionFormView;

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInvoicingSubscriptionFormView = exports.getEditInvoicingSubscriptionDetailViewState = void 0;
+exports.getInvoicingSubscriptionFormView = exports.getInvoicingItemsAllowedForPlan = exports.getEditInvoicingSubscriptionDetailViewState = void 0;
 const reduceFetchState_1 = require("../../../commonStateTypes/reduceFetchState");
 const addressSelector_1 = require("../../../entity/address/addressSelector");
 const invoicingSubscriptionSelector_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionSelector");
@@ -60,6 +60,99 @@ const isShippingAddressUnsaved = (state, id, savedShippingAddressId) => {
         pending.country === saved.country &&
         (pending.countryCode ?? '') === (saved.countryCode ?? ''));
 };
+/**
+ * The add-ons / one-time charges a plan actually accepts.
+ *
+ * A catalog item is either `restricted` — it names the item ids it may be
+ * subscribed alongside in `applicableItems` — or unrestricted, in which case
+ * every item is fair game. Matching is on `itemID` (the catalog item the price
+ * row was flattened from), not the price code, because applicability is
+ * declared item-to-item.
+ *
+ * Fails open where the rule is unknown: no plan selected yet, a plan that is
+ * not `restricted`, or a `restricted` plan whose allow-list never came down all
+ * return the full list. The create/update endpoint rejects a disallowed item
+ * with a 422 regardless, so offering one too many costs a server error the user
+ * already gets today, where hiding one too few makes a legitimate add-on
+ * unreachable with nothing on screen to explain why.
+ *
+ * An allow-list that arrived *empty* is not unknown — a restricted item is
+ * saved with `applicable_items: []` when nothing was picked — so that narrows
+ * to nothing, as the server does.
+ *
+ * Lives here rather than in a screen so the create/edit form and the detail
+ * page's inline edit narrow their pickers by the same rule.
+ */
+const getInvoicingItemsAllowedForPlan = (products, plan) => {
+    const allowedItemIDs = plan?.applicableItems;
+    if (plan?.itemApplicability !== 'restricted' || allowedItemIDs == null) {
+        return products;
+    }
+    return products.filter((product) => product.itemID != null && allowedItemIDs.includes(product.itemID));
+};
+exports.getInvoicingItemsAllowedForPlan = getInvoicingItemsAllowedForPlan;
+/**
+ * A price row can only be subscribed by its price code, so one without a code
+ * is not an option the form can offer.
+ */
+const hasInvoicingPriceCode = (product) => product.priceCode != null && product.priceCode.trim() !== '';
+/**
+ * `displayPrice` is the service-computed single-unit amount. Tiered, volume and
+ * stairstep price points store `price` as `0` because the money lives in their
+ * tiers, so `price` is only a fallback for responses predating `displayPrice`.
+ */
+const invoicingUnitPrice = (product) => product.displayPrice ?? product.price;
+const toInvoicingPlanOption = (plan) => ({
+    billingCycles: plan.billingCycles,
+    // The price point's own cadence: the backend derives billing period from the
+    // price point and rejects a subscription that claims a different one.
+    billingPeriod: plan.period,
+    billingPeriodUnit: plan.periodUnit,
+    label: plan.name ?? plan.id,
+    price: invoicingUnitPrice(plan),
+    productCode: plan.productCode,
+    trialPeriod: plan.trialPeriod,
+    trialPeriodUnit: plan.trialPeriodUnit,
+    value: plan.priceCode,
+});
+const toInvoicingCatalogItemOption = (product) => ({
+    // A one-time charge has no cadence, so its price is quoted flat rather than
+    // per period.
+    billingPeriodUnit: product.itemType === 'charge' ? undefined : product.periodUnit,
+    label: product.name ?? product.id,
+    price: invoicingUnitPrice(product),
+    productCode: product.productCode,
+    value: product.priceCode,
+});
+const toInvoicingCouponOption = (coupon) => ({
+    label: coupon.name ?? coupon.couponCode ?? coupon.id,
+    // Create/apply/remove coupon APIs resolve by coupon_code.
+    value: coupon.couponCode ?? coupon.id,
+});
+/**
+ * Company first, then the person's name, then the email — whichever the
+ * customer actually has. The id is the last resort so a record with no
+ * identifying field at all is still selectable rather than a blank row.
+ */
+const invoicingCustomerDisplayName = (customer) => {
+    const fullName = [customer.firstName, customer.lastName]
+        .filter((part) => part != null && part.trim() !== '')
+        .join(' ')
+        .trim();
+    const company = customer.company?.trim() ?? '';
+    const email = customer.email?.trim() ?? '';
+    return company !== ''
+        ? company
+        : fullName !== ''
+            ? fullName
+            : email !== ''
+                ? email
+                : customer.id;
+};
+const toInvoicingCustomerOption = (customer) => ({
+    label: invoicingCustomerDisplayName(customer),
+    value: customer.id,
+});
 const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
     const { editDraftById, error, fetchState, newSubscriptionDraft, savedSubscriptionId, } = state.editInvoicingSubscriptionDetailViewState;
     const mode = invoicingSubscriptionID != null ? 'edit' : 'create';
@@ -81,8 +174,15 @@ const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
         : undefined;
     const hasUnsavedShippingAddress = isShippingAddressUnsaved(state, invoicingSubscriptionID, subscription?.shippingAddressId);
     const catalogListView = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogListView)(state);
-    const planPrices = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.plans);
-    const addonAndChargePrices = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.products);
+    const planPrices = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.plans).filter(hasInvoicingPriceCode);
+    // A restricted plan names the catalog items it may be sold with, so the
+    // pickers offer only those: subscription create rejects the rest with a 422,
+    // and an option that can only fail is not a choice. The applicability rides
+    // on the price rows already in the store, so this is a join, not a refetch.
+    const allowedCatalogPrices = (0, exports.getInvoicingItemsAllowedForPlan)((0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.products), planPrices.find((plan) => plan.priceCode === localData.planPriceCode)).filter(hasInvoicingPriceCode);
+    const catalogItemOptionsOfType = (itemType) => allowedCatalogPrices
+        .filter((product) => product.itemType === itemType)
+        .map(toInvoicingCatalogItemOption);
     // In create mode there is nothing to load, so the record state only applies
     // when editing an existing subscription.
     const recordState = invoicingSubscriptionID != null
@@ -104,12 +204,13 @@ const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
         recordState,
         isFormLoading: (0, invoicingFormDraft_1.isInvoicingFormDraftPending)(editDraftById, invoicingSubscriptionID),
         fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'subscription'),
-        coupons: (0, couponViewSelector_1.getInvoicingCouponListItems)(state),
-        customers: (0, invoicingCustomerListViewSelector_1.getInvoicingCustomerListView)(state).customers,
+        addons: catalogItemOptionsOfType('addon'),
+        charges: catalogItemOptionsOfType('charge'),
+        coupons: (0, couponViewSelector_1.getInvoicingCouponListItems)(state).map(toInvoicingCouponOption),
+        customers: (0, invoicingCustomerListViewSelector_1.getInvoicingCustomerListView)(state).customers.map(toInvoicingCustomerOption),
         localData,
         mode,
-        plans: planPrices,
-        products: addonAndChargePrices,
+        plans: planPrices.map(toInvoicingPlanOption),
         savedSubscriptionId,
         shippingAddressLabel,
         hasUnsavedShippingAddress,

package/lib/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewSelector.d.ts

@@ -27,6 +27,16 @@ export interface InvoicingCatalogListView extends SelectorView {
      */
     runningActionId?: ID;
 }
+/**
+ * Flatten catalog items into the price rows the pickers render.
+ *
+ * The parent item's `applicableItems` / `itemApplicability` are carried onto
+ * every row it produces: applicability is a property of the catalog item, not
+ * of its price points, and a row that has lost it cannot be matched against the
+ * selected plan's allow-list (see `getInvoicingItemsAllowedForPlan`). Both are
+ * written after the spread so the item's own rule wins over any stale copy a
+ * price point payload may carry.
+ */
 export declare const getInvoicingCatalogPrices: (items: InvoicingPlan[]) => InvoicingProduct[];
 /**
  * Bundled read view for the single catalog page (plans + products tabs).

package/lib/view/invoicing/invoicingCatalogListView/invoicingCatalogListViewSelector.js

@@ -5,8 +5,20 @@ const toolkit_1 = require("@reduxjs/toolkit");
 const planSelector_1 = require("../../../entity/invoicing/plan/planSelector");
 const runningInvoicingActionId_1 = require("../runningInvoicingActionId");
 const invoicingCatalogListViewState_1 = require("./invoicingCatalogListViewState");
+/**
+ * Flatten catalog items into the price rows the pickers render.
+ *
+ * The parent item's `applicableItems` / `itemApplicability` are carried onto
+ * every row it produces: applicability is a property of the catalog item, not
+ * of its price points, and a row that has lost it cannot be matched against the
+ * selected plan's allow-list (see `getInvoicingItemsAllowedForPlan`). Both are
+ * written after the spread so the item's own rule wins over any stale copy a
+ * price point payload may carry.
+ */
 const getInvoicingCatalogPrices = (items) => items.flatMap((item) => (item.subFamilies ?? []).map((subFamily) => ({
     ...subFamily,
+    applicableItems: item.applicableItems,
+    itemApplicability: item.itemApplicability,
     itemID: item.id,
     itemType: item.type ?? item.itemType,
     name: subFamily.name,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zeniai/client-epic-state",
-  "version": "5.2.59",
+  "version": "5.2.60",
   "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
   "main": "lib/index.js",
   "module": "lib/esm/index.js",