@zeniai/client-epic-state 5.2.3 → 5.2.5

package/lib/view/aiCfoView/epics/toSkillDetail.d.ts

@@ -0,0 +1,88 @@
+import { SkillDetailDataPayload, SkillSummaryPayload } from '../aiCfoViewPayload';
+import { Skill, SkillDetail, SkillVisibility } from '../aiCfoViewState';
+/**
+ * A wire string narrowed to {@link SkillVisibility}, or null.
+ *
+ * A converter rather than passing the raw string through, because `Skill.visibility` is a
+ * union on the state type and this is the boundary where an unvalidated payload becomes
+ * it — the repo's rule about explicit converters at scalar boundaries instead of a bare
+ * cast.
+ *
+ * Unrecognised maps to NULL, not to `'private'`. Null already means "does not apply" for a
+ * Zeni default, and consumers show no audience badge for it — so an unknown tier renders
+ * as no badge. Defaulting to `'private'` would instead label a skill the whole tenant can
+ * run as author-only, which is a confident lie rather than a visible gap.
+ */
+export declare const toSkillVisibility: (raw: string | null | undefined) => SkillVisibility | null;
+/**
+ * What the version-body read needs, and nothing more.
+ *
+ * A `Pick` of the payload rather than a type of its own: `SkillDetailDataPayload` now
+ * marks the three unchecked fields optional itself, the same way `SkillSummaryPayload`
+ * does, so there is one idiom for "this endpoint is not schema-validated" instead of two.
+ */
+type PromptBody = Pick<SkillDetailDataPayload, 'instructions'>;
+/**
+ * Everything about a skill summary EXCEPT `exampleHints`, which no shared mapper can
+ * honestly supply.
+ *
+ * Only the LIST route returns `parameter_hints`; the detail and write routes do not. A
+ * shared mapper hardcoding `exampleHints: []` would put a "try: …" line under a skill
+ * that has hints, or drop them from the menu — so the field is `Omit`ted and each caller
+ * spreads in what its own route actually knows.
+ *
+ * Returning `Omit<Skill, 'exampleHints'>` rather than duplicating the mapper is what
+ * makes a new `Skill` field land in one place: this function stops compiling until the
+ * field is mapped, and both callers inherit it. The previous shape — two full copies —
+ * is how `isMine` was nearly added to only one of them, which would have silently
+ * withheld the edit and delete controls on whichever surface was missed.
+ */
+export declare const toBaseSkill: (payload: SkillSummaryPayload) => Omit<Skill, "exampleHints">;
+/**
+ * Whether a 2xx body carries a prompt.
+ *
+ * Narrows to {@link PromptBody} and NOT to the whole payload, because the only consumer —
+ * the version-body read — dereferences `instructions` and nothing else. Asserting the
+ * whole shape here would claim `skill` was checked when it was not, and tying the read to
+ * it would fail a response whose prompt was fine and whose `skill` block was malformed,
+ * which is exactly what happened when this was one predicate instead of two.
+ *
+ * Takes `unknown`: the input is an unvalidated network body, and typing the parameter as
+ * the payload interface would assume the very thing being checked.
+ */
+export declare const hasPromptBody: (data: unknown) => data is PromptBody;
+/**
+ * Whether a 2xx body can build a whole {@link SkillDetail}.
+ *
+ * Narrows to the payload type itself, which is now truthful: the two fields this checks
+ * are the two the interface still declares required, and the other three are optional
+ * there. Stricter than {@link hasPromptBody} by exactly one field. Four epics read this shape
+ * and each used to guard it differently — `data != null`, `data?.skill != null`, and a
+ * real `instructions` check — so one malformed response became a failure in one place, an
+ * empty prompt in another, and `undefined` in a third.
+ */
+export declare const isSkillDetailPayload: (data: unknown) => data is SkillDetailDataPayload;
+/**
+ * The detail payload every write route answers with.
+ *
+ * Shared because three epics need it — save, visibility, and the detail read — and a
+ * fourth copy is how one of them quietly stops carrying a field the others do.
+ *
+ * The coercions are not defensive habit; the payload type makes them mandatory — the
+ * three optional fields cannot be assigned to a non-optional `SkillDetail` without one.
+ * Which fields get coerced and which do not is the deliberate part:
+ *
+ * - `instructions` is load-bearing and already proven, so it passes through. Defaulting a
+ *   missing prompt to `''` is the one thing this module exists to prevent: the user
+ *   cannot tell an empty prompt from a skill that has one, and may save over the real
+ *   thing.
+ * - `instructionsCharCount` falls back to the prompt's own length, NOT to 0. A 12,000
+ *   character prompt displayed as "0 characters" is a lie the user can see, and the
+ *   prompt is right here to measure. Approximate only for astral-plane characters, where
+ *   UTF-16 units and the server's count differ — a rounding error, against a guaranteed
+ *   wrong answer.
+ * - `artifact` and `artifactTitle` degrade to empty. They render a preview card, so
+ *   losing them costs a card; failing the whole read would cost the user the skill.
+ */
+export declare const toSkillDetail: (payload: SkillDetailDataPayload) => SkillDetail;
+export {};

package/lib/view/aiCfoView/epics/toSkillDetail.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.toSkillDetail = exports.isSkillDetailPayload = exports.hasPromptBody = exports.toBaseSkill = exports.toSkillVisibility = void 0;
+/**
+ * Every value `SkillVisibility` admits, as data so the converter below cannot drift from
+ * the type. Adding a tier to the union without adding it here is a compile error.
+ */
+const SKILL_VISIBILITIES = ['private', 'tenant'];
+/**
+ * A wire string narrowed to {@link SkillVisibility}, or null.
+ *
+ * A converter rather than passing the raw string through, because `Skill.visibility` is a
+ * union on the state type and this is the boundary where an unvalidated payload becomes
+ * it — the repo's rule about explicit converters at scalar boundaries instead of a bare
+ * cast.
+ *
+ * Unrecognised maps to NULL, not to `'private'`. Null already means "does not apply" for a
+ * Zeni default, and consumers show no audience badge for it — so an unknown tier renders
+ * as no badge. Defaulting to `'private'` would instead label a skill the whole tenant can
+ * run as author-only, which is a confident lie rather than a visible gap.
+ */
+const toSkillVisibility = (raw) => SKILL_VISIBILITIES.find((known) => known === raw) ?? null;
+exports.toSkillVisibility = toSkillVisibility;
+/**
+ * Everything about a skill summary EXCEPT `exampleHints`, which no shared mapper can
+ * honestly supply.
+ *
+ * Only the LIST route returns `parameter_hints`; the detail and write routes do not. A
+ * shared mapper hardcoding `exampleHints: []` would put a "try: …" line under a skill
+ * that has hints, or drop them from the menu — so the field is `Omit`ted and each caller
+ * spreads in what its own route actually knows.
+ *
+ * Returning `Omit<Skill, 'exampleHints'>` rather than duplicating the mapper is what
+ * makes a new `Skill` field land in one place: this function stops compiling until the
+ * field is mapped, and both callers inherit it. The previous shape — two full copies —
+ * is how `isMine` was nearly added to only one of them, which would have silently
+ * withheld the edit and delete controls on whichever surface was missed.
+ */
+const toBaseSkill = (payload) => ({
+    macroId: payload.macro_id,
+    name: payload.name,
+    displayName: payload.display_name,
+    description: payload.description,
+    semver: payload.semver,
+    hasScripts: payload.has_scripts === true,
+    // === true, so an absent field withholds the write controls rather than offering ones
+    // the API refuses.
+    isMine: payload.is_mine === true,
+    isOwnedByTenant: payload.is_owned_by_tenant === true,
+    updatedAt: payload.updated_at ?? null,
+    visibility: (0, exports.toSkillVisibility)(payload.visibility),
+});
+exports.toBaseSkill = toBaseSkill;
+/**
+ * Whether a 2xx body carries a prompt.
+ *
+ * Narrows to {@link PromptBody} and NOT to the whole payload, because the only consumer —
+ * the version-body read — dereferences `instructions` and nothing else. Asserting the
+ * whole shape here would claim `skill` was checked when it was not, and tying the read to
+ * it would fail a response whose prompt was fine and whose `skill` block was malformed,
+ * which is exactly what happened when this was one predicate instead of two.
+ *
+ * Takes `unknown`: the input is an unvalidated network body, and typing the parameter as
+ * the payload interface would assume the very thing being checked.
+ */
+const hasPromptBody = (data) => typeof data?.instructions ===
+    'string';
+exports.hasPromptBody = hasPromptBody;
+/**
+ * Whether a 2xx body can build a whole {@link SkillDetail}.
+ *
+ * Narrows to the payload type itself, which is now truthful: the two fields this checks
+ * are the two the interface still declares required, and the other three are optional
+ * there. Stricter than {@link hasPromptBody} by exactly one field. Four epics read this shape
+ * and each used to guard it differently — `data != null`, `data?.skill != null`, and a
+ * real `instructions` check — so one malformed response became a failure in one place, an
+ * empty prompt in another, and `undefined` in a third.
+ */
+const isSkillDetailPayload = (data) => (0, exports.hasPromptBody)(data) && data.skill != null;
+exports.isSkillDetailPayload = isSkillDetailPayload;
+/**
+ * The detail payload every write route answers with.
+ *
+ * Shared because three epics need it — save, visibility, and the detail read — and a
+ * fourth copy is how one of them quietly stops carrying a field the others do.
+ *
+ * The coercions are not defensive habit; the payload type makes them mandatory — the
+ * three optional fields cannot be assigned to a non-optional `SkillDetail` without one.
+ * Which fields get coerced and which do not is the deliberate part:
+ *
+ * - `instructions` is load-bearing and already proven, so it passes through. Defaulting a
+ *   missing prompt to `''` is the one thing this module exists to prevent: the user
+ *   cannot tell an empty prompt from a skill that has one, and may save over the real
+ *   thing.
+ * - `instructionsCharCount` falls back to the prompt's own length, NOT to 0. A 12,000
+ *   character prompt displayed as "0 characters" is a lie the user can see, and the
+ *   prompt is right here to measure. Approximate only for astral-plane characters, where
+ *   UTF-16 units and the server's count differ — a rounding error, against a guaranteed
+ *   wrong answer.
+ * - `artifact` and `artifactTitle` degrade to empty. They render a preview card, so
+ *   losing them costs a card; failing the whole read would cost the user the skill.
+ */
+const toSkillDetail = (payload) => ({
+    skill: { ...(0, exports.toBaseSkill)(payload.skill), exampleHints: [] },
+    instructions: payload.instructions,
+    instructionsCharCount: payload.instructions_char_count ?? payload.instructions.length,
+    artifact: payload.artifact ?? '',
+    artifactTitle: payload.artifact_title ?? '',
+});
+exports.toSkillDetail = toSkillDetail;

package/lib/view/companyView/types/cockpitTabsID.d.ts

@@ -1,5 +1,5 @@
 export declare const ALL_COCKPIT_TABS_IDS: readonly ["management", "subscription", "portfolio", "onboarding", "audit", "healthMonitor"];
-export declare const toCockpitTabsIDStrict: (v: string) => "onboarding" | "management" | "subscription" | "portfolio" | "audit" | "healthMonitor" | undefined;
+export declare const toCockpitTabsIDStrict: (v: string) => "onboarding" | "subscription" | "management" | "portfolio" | "audit" | "healthMonitor" | undefined;
 export type CockpitTabsID = NonNullable<ReturnType<typeof toCockpitTabsIDStrict>>;
 export type CockpitDownloadTabsID = Exclude<CockpitTabsID, 'audit'>;
 export declare const ALL_COCKPIT_TABS_FILE_TYPES: readonly ["excel"];

package/lib/view/companyView/types/cockpitTypes.d.ts

@@ -4,9 +4,9 @@ import { SubscriptionViewSortKey } from '../../subscriptionView/types/subscripti
 import { CockpitDownloadTabsID, CockpitTabsFileType } from './cockpitTabsID';
 export type FilterCategoryValueType = string | ZeniDate;
 export declare const toPortfolioSortKeyType: (v: string) => "expenses" | "runway" | "companyName" | "cashBalance" | "revenues" | "netIncome";
-export declare const toManagementSortKeyType: (v: string) => "status" | "bookCloseDate" | "controller" | "preparer" | "reviewer" | "taxStatus" | "companyName" | "plans" | "monthlyRecurringRevenue" | "notes" | "task" | "group" | "productVerticals" | "realmId" | "customerSuccessManager" | "apAnalyst" | "reportSent" | "taxLead" | "annualRecurringRevenue" | "satisfaction";
+export declare const toManagementSortKeyType: (v: string) => "status" | "bookCloseDate" | "controller" | "preparer" | "reviewer" | "taxStatus" | "group" | "companyName" | "plans" | "monthlyRecurringRevenue" | "notes" | "task" | "productVerticals" | "realmId" | "customerSuccessManager" | "apAnalyst" | "reportSent" | "taxLead" | "annualRecurringRevenue" | "satisfaction";
 export declare const toOnboardingSortKeyType: (v: string) => "companyName" | "notes" | "bankAccountLinked" | "qboLinked" | "identityVerified" | "businessVerified" | "groupCreated" | "customerCreated" | "enroller" | "invite" | "latestCreated";
-export declare const toHealthSortKeyType: (v: string) => "controller" | "runway" | "companyName" | "monthlyRecurringRevenue" | "group" | "productVerticals" | "customerSuccessManager" | "issues" | "externalProductServiceExposure" | "companyEngagementMetricsUpdatedAt" | "churnProbability" | "netPromoterScore" | "customerSatisfactionScore" | "lastReportSent" | "subscriptionDate" | "renewalDate" | "dashboardLastSeen" | "lastEngagement";
+export declare const toHealthSortKeyType: (v: string) => "controller" | "group" | "runway" | "companyName" | "monthlyRecurringRevenue" | "productVerticals" | "customerSuccessManager" | "issues" | "externalProductServiceExposure" | "companyEngagementMetricsUpdatedAt" | "churnProbability" | "netPromoterScore" | "customerSatisfactionScore" | "lastReportSent" | "subscriptionDate" | "renewalDate" | "dashboardLastSeen" | "lastEngagement";
 export declare const toTaskManagerSortKeyType: (v: string) => "status" | "dueDate" | "name" | "taskName" | "priority" | "assignee" | "tags" | "createdBy";
 export type PortfolioViewSortKey = ReturnType<typeof toPortfolioSortKeyType>;
 export type ManagementViewSortKey = ReturnType<typeof toManagementSortKeyType>;

package/lib/view/invoicing/auditView/auditViewPayload.d.ts

@@ -35,6 +35,7 @@ export interface InvoicingAuditLogApiEntry {
     target: string;
     time: string;
     timestamp: string;
+    action_label?: string;
     change_summary?: unknown[];
     changes?: unknown[];
     context?: Record<string, unknown>;
@@ -69,6 +70,7 @@ export interface InvoicingAuditEntry {
     action: string;
     target: string;
     time: string;
+    actionLabel?: string;
     actor?: string;
     customerId?: string;
     detailSegments?: AuditLogDisplaySegment[];

package/lib/view/invoicing/auditView/auditViewPayload.js

@@ -42,6 +42,16 @@ function formatActor(actor, sourceLabel) {
     }
     return name;
 }
+/**
+ * The backend's human-readable action text, or `undefined` when it carries none.
+ * Blank copy collapses to `undefined` so the UI's `humanizeToken` fallback runs
+ * instead of rendering an empty Action cell, and surrounding whitespace is
+ * trimmed so the stored value is what should be displayed verbatim.
+ */
+function invoicingAuditActionLabel(actionLabel) {
+    const trimmed = actionLabel?.trim() ?? '';
+    return trimmed !== '' ? trimmed : undefined;
+}
 function mapAuditLogEntry(entry) {
     const sourceLabel = entry.source_label ?? '';
     return {
@@ -52,6 +62,7 @@ function mapAuditLogEntry(entry) {
         source: entry.source,
         sourceLabel: sourceLabel || undefined,
         action: entry.action,
+        actionLabel: invoicingAuditActionLabel(entry.action_label),
         entityId: entry.entity_id,
         entityType: entry.entity_type,
         customerId: entry.customer_id ?? undefined,

package/lib/view/invoicing/couponView/couponViewState.d.ts

@@ -5,7 +5,7 @@ export interface InvoicingCouponFilters {
     search?: string;
 }
 export declare const ALL_INVOICING_COUPON_SORT_KEYS: readonly ["coupon_id", "name", "discount", "duration", "created", "valid_till", "apply_on", "status", "redemptions"];
-export declare const toInvoicingCouponSortKey: (v: string) => "status" | "name" | "coupon_id" | "discount" | "duration" | "created" | "valid_till" | "apply_on" | "redemptions";
+export declare const toInvoicingCouponSortKey: (v: string) => "status" | "name" | "discount" | "coupon_id" | "duration" | "created" | "valid_till" | "apply_on" | "redemptions";
 export type InvoicingCouponSortKey = ReturnType<typeof toInvoicingCouponSortKey>;
 /**
  * Structural column descriptor owned by CES so the discounts-list column set,

package/lib/view/invoicing/createInvoice/createInvoiceSelector.d.ts

@@ -1,7 +1,7 @@
 import { ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { Address } from '../../../entity/address/addressState';
-import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingFieldHelpByCode, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { InvoicingProduct } from '../../../entity/invoicing/product/productState';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingCreateInvoiceFormLocalData } from './createInvoiceState';
@@ -26,6 +26,11 @@ export interface InvoicingCreateInvoiceCustomerOption {
 }
 export interface CreateInvoiceFormView extends SelectorView {
     customers: InvoicingCreateInvoiceCustomerOption[];
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     localData: InvoicingCreateInvoiceFormLocalData;
     planNames: InvoicingPlanNameOption[];
     products: InvoicingProduct[];

package/lib/view/invoicing/createInvoice/createInvoiceSelector.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCreateInvoiceFormView = void 0;
 const addressSelector_1 = require("../../../entity/address/addressSelector");
 const invoicingCatalogListViewSelector_1 = require("../invoicingCatalogListView/invoicingCatalogListViewSelector");
+const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const invoicingCustomerListViewSelector_1 = require("../invoicingCustomerListView/invoicingCustomerListViewSelector");
 const settingsViewSelector_1 = require("../settingsView/settingsViewSelector");
 /**
@@ -35,6 +36,7 @@ const getCreateInvoiceFormView = (state) => {
     const createInvoiceState = state.invoicingCreateInvoiceState;
     const catalogListView = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogListView)(state);
     return {
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'invoice'),
         customers: (0, invoicingCustomerListViewSelector_1.getInvoicingCustomerListView)(state).customers.map((customer) => ({
             billingAddress: customer.billingAddressId != null
                 ? (0, addressSelector_1.getAddressByAddressId)(state.addressState, customer.billingAddressId)

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

@@ -1,6 +1,6 @@
 import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
-import { InvoicingNamedOption, InvoicingNamedOptionsByKey } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingFieldHelpByCode, InvoicingNamedOption, InvoicingNamedOptionsByKey } from '../../../entity/invoicing/invoicingCommonPayload';
 import { InvoicingPlan } from '../../../entity/invoicing/plan/planState';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingCatalogItemKind } from '../invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewState';
@@ -30,6 +30,11 @@ export declare const getInvoicingApplicableCatalogItemOptions: (state: RootState
 export interface InvoicingCatalogItemFormView extends SelectorView {
     applicabilityValues: readonly string[];
     applicableItemOptions: ApplicableCatalogItemOption[];
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     localData: InvoicingCatalogItemFormLocalData;
     mode: 'create' | 'edit';
     periodUnitOptions: InvoicingNamedOption[];

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

@@ -56,6 +56,7 @@ const getInvoicingCatalogItemFormView = (state, id) => {
         : allApplicableItemOptions;
     const { billingPeriodUnitOptions, catalogItemTypeOptions, catalogTierTypeOptionsByPricingModel, catalogTrialEndActionOptions, catalogTrialUnitOptions, } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     return {
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'catalog'),
         applicabilityValues: invoicingCatalogItemFormConfig_1.INVOICING_CATALOG_APPLICABILITY_VALUES,
         applicableItemOptions,
         localData,

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

@@ -1,7 +1,7 @@
 import { FetchState, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { InvoicingCoupon } from '../../../entity/invoicing/coupon/couponState';
-import { InvoicingDiscountLifecycleActionOption, InvoicingFormOption } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingDiscountLifecycleActionOption, InvoicingFieldHelpByCode, InvoicingFormOption } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingCouponFormLocalData } from './editInvoicingCouponDetailViewState';
 export interface EditInvoicingCouponDetailView extends SelectorView {
@@ -21,6 +21,11 @@ export interface InvoicingCouponFormView extends EditInvoicingCouponDetailView {
     applyOnOptions: InvoicingFormOption[];
     discountTypeOptions: InvoicingFormOption[];
     durationTypeOptions: InvoicingFormOption[];
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     localData: InvoicingCouponFormLocalData;
     mode: 'create' | 'edit';
     periodUnitOptions: InvoicingFormOption[];

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

@@ -41,6 +41,7 @@ const getInvoicingCouponFormView = (state, couponId) => {
         : newCouponDraft;
     const { billingPeriodUnitOptions, discountApplyOnOptions, discountDurationTypeOptions, discountTypeOptions, } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     return {
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'discount'),
         ...base,
         applyOnOptions: discountApplyOnOptions.map(invoicingCommonPayload_1.toInvoicingFormOption),
         discountTypeOptions: discountTypeOptions.map(invoicingCommonPayload_1.toInvoicingFormOption),

package/lib/view/invoicing/editInvoicingCustomerDetailView/editInvoicingCustomerDetailViewSelector.d.ts

@@ -1,10 +1,15 @@
 import { ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
-import { InvoicingNamedOption } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingFieldHelpByCode, InvoicingNamedOption } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingCustomerFormLocalData } from './editInvoicingCustomerDetailViewState';
 export interface InvoicingCustomerFormView extends SelectorView {
     customerTypeOptions: InvoicingNamedOption[];
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     localData: InvoicingCustomerFormLocalData;
     mode: 'create' | 'edit';
     netTermDayOptions: InvoicingNamedOption[];

package/lib/view/invoicing/editInvoicingCustomerDetailView/editInvoicingCustomerDetailViewSelector.js

@@ -32,6 +32,7 @@ const getInvoicingCustomerFormView = (state, invoicingCustomerID) => {
         : undefined;
     const { customerTypeOptions, netTermDayOptions, taxabilityOptions } = (0, invoicingConfigViewSelector_1.getInvoicingConfigView)(state);
     return {
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'customer'),
         customerTypeOptions,
         localData,
         mode,

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

@@ -11,5 +11,11 @@ export type SaveInvoicingSubscriptionResponse = ZeniAPIResponse<InvoicingSubscri
  * `remaining_billing_cycles` is omitted when the user left the field empty, so
  * the backend applies the plan's own `billing_cycles` (or renews forever when
  * the plan sets no limit) rather than being pinned to a value the form invented.
+ *
+ * `billing_period` / `billing_period_unit` are deliberately absent. Billing
+ * cadence is a property of the selected price point, not of the subscription,
+ * and the backend derives it from that price point when the fields are omitted.
+ * Sending them made every price point whose cadence the form could not express
+ * — a daily plan, for instance — fail with a 422.
  */
 export declare const localDataToSaveInvoicingSubscriptionPayload: (localData: InvoicingSubscriptionFormLocalData, shippingAddress?: AddressUpdatableInfo) => Record<string, unknown>;

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

@@ -11,9 +11,14 @@ const invoicingSubscriptionFormConfig_1 = require("./invoicingSubscriptionFormCo
  * `remaining_billing_cycles` is omitted when the user left the field empty, so
  * the backend applies the plan's own `billing_cycles` (or renews forever when
  * the plan sets no limit) rather than being pinned to a value the form invented.
+ *
+ * `billing_period` / `billing_period_unit` are deliberately absent. Billing
+ * cadence is a property of the selected price point, not of the subscription,
+ * and the backend derives it from that price point when the fields are omitted.
+ * Sending them made every price point whose cadence the form could not express
+ * — a daily plan, for instance — fail with a 422.
  */
 const localDataToSaveInvoicingSubscriptionPayload = (localData, shippingAddress) => {
-    const frequency = (0, invoicingSubscriptionFormConfig_1.billingFrequencyToPeriod)(localData.billingFrequency);
     const items = [
         {
             item_price_code: localData.planPriceCode,
@@ -38,8 +43,6 @@ const localDataToSaveInvoicingSubscriptionPayload = (localData, shippingAddress)
     const remainingBillingCycles = (0, invoicingSubscriptionFormConfig_1.toInvoicingSubscriptionBillingCycles)(localData.remainingBillingCycles);
     return {
         auto_collection: localData.autoCollection ? 'on' : 'off',
-        billing_period: frequency.period,
-        billing_period_unit: frequency.unit,
         currency_code: localData.preferredCurrencyCode,
         customer_id: localData.customerId,
         started_at: startedAt !== '' ? startedAt : (0, invoicingSubscriptionFormConfig_1.invoicingSubscriptionTodayIso)(),

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

@@ -1,7 +1,7 @@
 import { ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { InvoicingCoupon } from '../../../entity/invoicing/coupon/couponState';
-import { InvoicingSubscriptionLifecycleActionOption } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingFieldHelpByCode, 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';
@@ -30,9 +30,13 @@ export interface EditInvoicingSubscriptionDetailView extends SelectorView {
  * to its own option shapes, so this stays free of any web-components dependency.
  */
 export interface InvoicingSubscriptionFormView extends SelectorView {
-    billingFrequencyValues: string[];
     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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     localData: InvoicingSubscriptionFormLocalData;
     mode: 'create' | 'edit';
     plans: InvoicingProduct[];

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

@@ -46,9 +46,7 @@ const getInvoicingSubscriptionFormView = (state, invoicingSubscriptionID) => {
     const planPrices = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.plans);
     const addonAndChargePrices = (0, invoicingCatalogListViewSelector_1.getInvoicingCatalogPrices)(catalogListView.products);
     return {
-        billingFrequencyValues: [
-            ...invoicingSubscriptionFormConfig_1.INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES,
-        ],
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'subscription'),
         coupons: (0, couponViewSelector_1.getInvoicingCouponListItems)(state),
         customers: (0, invoicingCustomerListViewSelector_1.getInvoicingCustomerListView)(state).customers,
         localData,

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

@@ -16,7 +16,6 @@ export interface InvoicingSubscriptionFormLocalData {
      */
     addonQuantities: Record<string, number>;
     autoCollection: boolean;
-    billingFrequency: string;
     chargePriceCodes: string[];
     /** Per-charge quantity, keyed by item price code. See `addonQuantities`. */
     chargeQuantities: Record<string, number>;

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

@@ -2,19 +2,6 @@ import { InvoicingSubscription } from '../../../entity/invoicing/invoicingSubscr
 import { InvoicingSubscriptionFormLocalData } from './editInvoicingSubscriptionDetailViewState';
 /** `AddressType` key used when the subscription form opens the shared Address screen. */
 export declare const INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE: "invoicing_subscription_shipping_address";
-/**
- * Canonical billing-frequency value set for the subscription form. CES owns the
- * values (and their period/unit mapping); web-components maps each value to a
- * localized label (same split as the customer form's value sets).
- */
-export declare const INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES: readonly ["weekly", "monthly", "quarterly", "half_yearly", "yearly"];
-/** Map a billing-frequency value to its API `billing_period` / `billing_period_unit`. */
-export declare const billingFrequencyToPeriod: (value: string) => {
-    period: number;
-    unit: string;
-};
-/** Map an existing subscription's period/unit back to a billing-frequency value. */
-export declare const periodToBillingFrequency: (period?: number, unit?: string) => string;
 /**
  * Today as `YYYY-MM-DD`, the default subscription start date. Goes through
  * dayjs (not `toISOString`, which is UTC) so a user in a UTC+ timezone late in

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

@@ -1,40 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.entityToInvoicingSubscriptionFormLocalData = exports.initialInvoicingSubscriptionFormLocalData = exports.toInvoicingSubscriptionBillingCycles = exports.toInvoicingSubscriptionQuantity = exports.invoicingSubscriptionTodayIso = exports.periodToBillingFrequency = exports.billingFrequencyToPeriod = exports.INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES = exports.INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE = void 0;
+exports.entityToInvoicingSubscriptionFormLocalData = exports.initialInvoicingSubscriptionFormLocalData = exports.toInvoicingSubscriptionBillingCycles = exports.toInvoicingSubscriptionQuantity = exports.invoicingSubscriptionTodayIso = exports.INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE = void 0;
 const zeniDayJS_1 = require("../../../zeniDayJS");
 /** `AddressType` key used when the subscription form opens the shared Address screen. */
 exports.INVOICING_SUBSCRIPTION_SHIPPING_ADDRESS_TYPE = 'invoicing_subscription_shipping_address';
-/**
- * Canonical billing-frequency value set for the subscription form. CES owns the
- * values (and their period/unit mapping); web-components maps each value to a
- * localized label (same split as the customer form's value sets).
- */
-exports.INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES = [
-    'weekly',
-    'monthly',
-    'quarterly',
-    'half_yearly',
-    'yearly',
-];
-const BILLING_FREQUENCY_TO_PERIOD = {
-    weekly: { period: 1, unit: 'week' },
-    monthly: { period: 1, unit: 'month' },
-    quarterly: { period: 3, unit: 'month' },
-    half_yearly: { period: 6, unit: 'month' },
-    yearly: { period: 1, unit: 'year' },
-};
-/** Map a billing-frequency value to its API `billing_period` / `billing_period_unit`. */
-const billingFrequencyToPeriod = (value) => BILLING_FREQUENCY_TO_PERIOD[value] ?? BILLING_FREQUENCY_TO_PERIOD.monthly;
-exports.billingFrequencyToPeriod = billingFrequencyToPeriod;
-/** Map an existing subscription's period/unit back to a billing-frequency value. */
-const periodToBillingFrequency = (period, unit) => {
-    const match = exports.INVOICING_SUBSCRIPTION_BILLING_FREQUENCY_VALUES.find((value) => {
-        const mapped = BILLING_FREQUENCY_TO_PERIOD[value];
-        return mapped.period === period && mapped.unit === unit;
-    });
-    return match ?? 'monthly';
-};
-exports.periodToBillingFrequency = periodToBillingFrequency;
 const subscriptionItemPriceCodes = (subscription, itemType) => subscription?.subscriptionItems
     ?.filter((item) => item.itemType === itemType)
     .map((item) => item.itemPriceCode)
@@ -88,7 +57,6 @@ exports.initialInvoicingSubscriptionFormLocalData = {
     addonPriceCodes: [],
     addonQuantities: {},
     autoCollection: true,
-    billingFrequency: 'monthly',
     chargePriceCodes: [],
     chargeQuantities: {},
     couponId: '',
@@ -111,7 +79,6 @@ const entityToInvoicingSubscriptionFormLocalData = (subscription) => {
         addonPriceCodes: subscriptionItemPriceCodes(subscription, 'addon'),
         addonQuantities: subscriptionItemQuantities(subscription, 'addon'),
         autoCollection: (subscription.autoCollection ?? 'on') === 'on',
-        billingFrequency: (0, exports.periodToBillingFrequency)(subscription.billingPeriod, subscription.billingPeriodUnit),
         chargePriceCodes: subscriptionItemPriceCodes(subscription, 'charge'),
         chargeQuantities: subscriptionItemQuantities(subscription, 'charge'),
         couponId: subscription.coupons?.[0]?.couponCode ??

package/lib/view/invoicing/invoiceDetail/invoiceDetailSelector.d.ts

@@ -2,6 +2,7 @@ import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
 import { Address } from '../../../entity/address/addressState';
 import { InvoicingInvoice } from '../../../entity/invoicing/invoice/invoiceState';
+import type { InvoicingFieldHelpByCode } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../rootStateTypes';
 /**
  * Read-only view for the invoice detail page: the invoice entity + its per-id
@@ -11,6 +12,11 @@ import { RootState } from '../../../rootStateTypes';
  */
 export interface InvoiceDetailView extends SelectorView {
     actionState: FetchStateAndError;
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     billingAddress?: Address;
     invoice?: InvoicingInvoice;
     shippingAddress?: Address;

package/lib/view/invoicing/invoiceDetail/invoiceDetailSelector.js

@@ -8,10 +8,12 @@ const get_1 = __importDefault(require("lodash/get"));
 const addressSelector_1 = require("../../../entity/address/addressSelector");
 const invoiceSelector_1 = require("../../../entity/invoicing/invoice/invoiceSelector");
 const invoiceActionSelector_1 = require("../invoiceAction/invoiceActionSelector");
+const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const getInvoiceDetail = (state, invoiceId) => {
     const detail = (0, get_1.default)(state.invoicingInvoiceDetailState.detailById, invoiceId, undefined);
     const invoice = (0, invoiceSelector_1.getInvoiceById)(state.invoicingInvoiceState, invoiceId);
     return {
+        fieldHelp: (0, invoicingConfigViewSelector_1.invoicingFieldHelpForGroup)(state, 'invoice'),
         invoice,
         billingAddress: invoice?.billingAddressId != null
             ? (0, addressSelector_1.getAddressByAddressId)(state.addressState, invoice.billingAddressId)

package/lib/view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewSelector.d.ts

@@ -1,6 +1,6 @@
 import { FetchState, ID } from '../../../commonStateTypes/common';
 import { SelectorView } from '../../../commonStateTypes/viewAndReport/viewAndReport';
-import { InvoicingCatalogItemLifecycleAction, InvoicingCatalogLifecycleActionOption, InvoicingCatalogProductLifecycleAction, InvoicingNamedOption, InvoicingNamedOptionsByKey } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingCatalogItemLifecycleAction, InvoicingCatalogLifecycleActionOption, InvoicingCatalogProductLifecycleAction, InvoicingFieldHelpByCode, InvoicingNamedOption, InvoicingNamedOptionsByKey } from '../../../entity/invoicing/invoicingCommonPayload';
 import { InvoicingPlan } from '../../../entity/invoicing/plan/planState';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingCatalogItemKind } from './invoicingCatalogItemDetailViewState';
@@ -20,6 +20,11 @@ export interface InvoicingCatalogItemDetailView extends SelectorView {
     catalogItemLifecycleActionOptions: InvoicingCatalogLifecycleActionOption<InvoicingCatalogItemLifecycleAction>[];
     catalogProductLifecycleActionOptions: InvoicingCatalogLifecycleActionOption<InvoicingCatalogProductLifecycleAction>[];
     configFetchState: FetchState;
+    /**
+     * 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.
+     */
+    fieldHelp: InvoicingFieldHelpByCode;
     /**
      * Config option lists the detail page's inline pricing editor renders, so the
      * screen reads them off this view instead of `getInvoicingConfigView`.