@zeniai/client-epic-state 5.1.91 → 5.1.92-beta0ND

package/lib/esm/view/invoicing/discountAction/discountActionEpic.js

@@ -1,8 +1,9 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCoupons } from '../../../entity/invoicing/coupon/couponReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingDiscountAction, runInvoicingDiscountActionFailure, runInvoicingDiscountActionSuccess, } from './discountActionReducer';
 /** Snackbar copy per action kind; unlisted kinds run without one. */
 const SNACKBAR_SECTION_BY_KIND = {
@@ -14,13 +15,15 @@ export const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => ac
     const { action: kind, id } = action.payload;
     const requestBody = { action: kind };
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/discounts/${encodeURIComponent(id)}/actions`;
@@ -39,7 +42,7 @@ export const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => ac
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingDiscountActionFailure({

package/lib/esm/view/invoicing/dunningAction/dunningActionEpic.js

@@ -1,8 +1,9 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingDunningCases } from '../../../entity/invoicing/dunningCase/dunningCaseReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingDunningAction, runInvoicingDunningActionFailure, runInvoicingDunningActionSuccess, } from './dunningActionReducer';
 /**
  * Snackbar copy is per action kind; anything not listed here runs without one.
@@ -15,13 +16,15 @@ const SNACKBAR_SECTION_BY_KIND = {
 export const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(runInvoicingDunningAction.match), mergeMap((action) => {
     const { action: kind, body, id } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/dunning/${encodeURIComponent(id)}/${kind}`;
@@ -40,7 +43,7 @@ export const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => act
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingDunningActionFailure({

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

@@ -80,6 +80,8 @@ const buildSubFamilyPayload = (localData, subFamily, clearEmptyValues) => {
     }
     return payload;
 };
+/** `unit` is the item's unit of measure, not a currency; `CURRENCY_CODE` above prices sub-families. */
+const DEFAULT_CATALOG_ITEM_UNIT = 'USD';
 /**
  * Build the parent catalog-item request body from the form draft. Creates omit
  * both parent and sub-family IDs; edits retain returned sub-family IDs.
@@ -101,10 +103,9 @@ export const localDataToSaveInvoicingCatalogItemPayload = (localData, isCreate)
     if (description != null) {
         itemPayload.description = description;
     }
-    const unit = trimOrUndefined(localData.unit);
-    if (unit != null) {
-        itemPayload.unit = unit;
-    }
+    // The form no longer collects a unit; an item that already has one keeps it.
+    itemPayload.unit =
+        trimOrUndefined(localData.unit) ?? DEFAULT_CATALOG_ITEM_UNIT;
     if (localData.itemApplicability === 'restricted' &&
         localData.applicableItems.length > 0) {
         itemPayload.applicable_items = localData.applicableItems;

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

@@ -2,6 +2,7 @@ import { forkJoin, from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { mergeInvoicingPlanSubFamily, updateInvoicingPlans, } from '../../../entity/invoicing/plan/planReducer';
 import { updateInvoicingProducts } from '../../../entity/invoicing/product/productReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { addInvoicingCatalogItem } from '../invoicingCatalogListView/invoicingCatalogListViewReducer';
@@ -45,6 +46,7 @@ export const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actio
                             messageSection: 'invoicing_catalog_item_saved',
                             messageText: 'failed',
                             type: 'error',
+                            variables: apiErrorSnackbarVariables(failedProductResponse.status),
                         }),
                     ]);
                 }
@@ -94,6 +96,7 @@ export const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actio
                 messageSection: 'invoicing_catalog_item_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/editInvoicingCouponDetailView/saveInvoicingCouponEpic.js

@@ -1,6 +1,7 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCoupons } from '../../../entity/invoicing/coupon/couponReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { addInvoicingCouponToList } from '../couponView/couponViewReducer';
@@ -57,6 +58,7 @@ export const saveInvoicingCouponEpic = (actions$, state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_coupon_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/editInvoicingCustomerDetailView/saveInvoicingCustomerEpic.js

@@ -3,6 +3,7 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingCustomerAddresses } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload';
 import { updateInvoicingCustomers } from '../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
@@ -59,6 +60,7 @@ export const saveInvoicingCustomerEpic = (actions$, state$, zeniAPI) => actions$
                 messageSection: 'invoicing_customer_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

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

@@ -3,6 +3,7 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { resetNewAddressDataInLocalStore } from '../../addressView/addressViewReducer';
@@ -45,6 +46,7 @@ export const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => acti
                     messageSection: 'invoicing_subscription_saved',
                     messageText: 'failed',
                     type: 'error',
+                    variables: apiErrorSnackbarVariables(response.status),
                 }),
             ];
         }

package/lib/esm/view/invoicing/invoiceAction/invoiceActionEpic.js

@@ -3,8 +3,9 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingInvoiceAddresses } from '../../../entity/invoicing/invoice/invoicePayload';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingInvoiceAction, runInvoicingInvoiceActionFailure, runInvoicingInvoiceActionSuccess, updateInvoicingInvoice, } from './invoiceActionReducer';
 /** Snackbar copy per action kind; unlisted kinds run without one. */
 const SNACKBAR_SECTION_BY_KIND = {
@@ -16,13 +17,15 @@ export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => act
     action.payload.action !== 'issue-credit-note'), mergeMap((action) => {
     const { action: kind, body, invoiceId } = action.payload;
     const snackbarSection = SNACKBAR_SECTION_BY_KIND[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
@@ -42,7 +45,7 @@ export const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => act
                 error: response.status,
                 invoiceId,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingInvoiceActionFailure({
@@ -80,6 +83,7 @@ export const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => action
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/invoicingQboView/epics/retryInvoicingQboSyncTaskEpic.js

@@ -1,5 +1,6 @@
 import { from, of } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { apiErrorSnackbarVariables } from '../../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchInvoicingQboSyncHealth, retryInvoicingQboSyncTask, retryInvoicingQboSyncTaskFailure, retryInvoicingQboSyncTaskSuccess, } from '../invoicingQboViewReducer';
@@ -28,6 +29,7 @@ export const retryInvoicingQboSyncTaskEpic = (actions$, _state$, zeniAPI) => act
                 messageSection: 'invoicing_qbo_sync_health_retry',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/invoicingQboView/epics/startInvoicingQboBackfillEpic.js

@@ -1,5 +1,6 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
+import { apiErrorSnackbarVariables } from '../../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
 import { fetchInvoicingQboSyncHealth, startInvoicingQboBackfill, startInvoicingQboBackfillFailure, startInvoicingQboBackfillSuccess, } from '../invoicingQboViewReducer';
@@ -27,6 +28,7 @@ export const startInvoicingQboBackfillEpic = (actions$, _state$, zeniAPI) => act
                 messageSection: 'invoicing_qbo_backfill',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/issueCreditNote/issueCreditNoteEpic.js

@@ -1,6 +1,7 @@
 import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoicingCreditNotes } from '../../../entity/invoicing/creditNote/creditNoteReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { fetchInvoiceDetail } from '../invoiceDetail/invoiceDetailReducer';
@@ -32,6 +33,7 @@ export const issueCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe(
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/recordPayment/recordPaymentEpic.js

@@ -2,6 +2,7 @@ import { from } from 'rxjs';
 import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateInvoices } from '../../../entity/invoicing/invoice/invoiceReducer';
 import { updateInvoicingTransactions } from '../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
 import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
 import { fetchInvoiceDetail } from '../invoiceDetail/invoiceDetailReducer';
@@ -40,6 +41,7 @@ export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(fi
                     messageSection: 'invoicing_payment_recorded',
                     messageText: 'failed',
                     type: 'error',
+                    variables: apiErrorSnackbarVariables(response.status),
                 }),
             ]);
         }), catchError((error) => from([
@@ -82,6 +84,7 @@ export const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe(fi
                 messageSection: 'invoicing_payment_recorded',
                 messageText: 'failed',
                 type: 'error',
+                variables: apiErrorSnackbarVariables(response.status),
             }),
         ]);
     }), catchError((error) => from([

package/lib/esm/view/invoicing/settingsView/settingsViewEpics.js

@@ -1,8 +1,9 @@
 import { from, of } from 'rxjs';
 import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection, } from './settingsViewReducer';
 export const fetchInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingSettings.match), switchMap(() => {
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
@@ -59,13 +60,15 @@ export const disconnectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => act
 export const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(saveInvoicingSettings.match), mergeMap((action) => {
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
     const { settings, snackbarSection } = action.payload;
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     return zeniAPI
@@ -79,7 +82,7 @@ export const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions
         }
         return from([
             saveInvoicingSettingsFailure(response.status),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         saveInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Save settings REST API call errored out ' +

package/lib/esm/view/invoicing/settingsView/settingsViewSelector.js

@@ -1,3 +1,4 @@
+import { getInvoicingQboAccountMappingId, } from '../../../entity/invoicing/invoicingCommonPayload';
 import { getFormattedAddress } from '../../addressView/addressViewSelector';
 import { getInvoicingConfigView } from '../invoicingConfigView/invoicingConfigViewSelector';
 import { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, } from './invoicingBrandingFormConfig';
@@ -30,6 +31,57 @@ export const getInvoicingSettingsView = (state) => {
         stripeConnectState: stripeFetchState,
     };
 };
+/**
+ * Gates the Enable Invoicing action: payments must be able to land (Stripe
+ * connected *and* accepting charges) and the QBO accounting step must be
+ * finished, so an enabled tenant can always book what it invoices.
+ *
+ * Deliberately not part of `deriveInvoicingOnboardingStatus`, which routes the
+ * module off the config flags alone. Folding these in there would (a) demote a
+ * live tenant to the settings tree the moment an integration broke, stranding
+ * its existing invoices, and (b) deadlock the route gate, which fetches only the
+ * config — never the settings or QBO connection these read.
+ */
+export function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qboAccountMappingKindOptions) {
+    const isStripeConnected = settings?.stripe_connected === true &&
+        settings?.stripe_account?.charges_enabled === true;
+    const accountMappings = settings?.qbo?.account_mappings ?? undefined;
+    // An empty option list means the config has not landed yet — treating that as
+    // configured would let `every` pass vacuously and unlock the button early.
+    const isQboConfigured = isQboConnected &&
+        qboAccountMappingKindOptions.length > 0 &&
+        qboAccountMappingKindOptions.every((option) => getInvoicingQboAccountMappingId(accountMappings, option.code) != null);
+    return {
+        canEnable: isStripeConnected && isQboConfigured,
+        isQboConfigured,
+        isStripeConnected,
+    };
+}
+/**
+ * The settings hub's composite of everything it derives from the store: whether
+ * to offer Enable Invoicing at all, the in-flight flag for that action, and the
+ * two integration prerequisites kept separate so the hub can name the step still
+ * outstanding instead of showing a dead button.
+ *
+ * `canEnableInvoicing` folds in the onboarding step, so the screen does not need
+ * to re-check it: the footer is only offered mid-onboarding and only once both
+ * integrations are ready.
+ *
+ * Deliberately not folded into `getInvoicingConfigView`: that selector gates
+ * every invoicing route and stays a pure read of the config slice. The settings
+ * and QBO slices read here are only fetched once a settings screen is mounted.
+ */
+export const getInvoicingSettingsHubView = (state) => {
+    const { enableState, qboAccountMappingKindOptions, status } = getInvoicingConfigView(state);
+    const { canEnable, isQboConfigured, isStripeConnected } = deriveInvoicingEnablePrerequisites(state.invoicingSettingsViewState.settings, state.invoicingQboViewState.connection?.connected === true, qboAccountMappingKindOptions);
+    return {
+        canEnableInvoicing: status === 'settings' && canEnable,
+        isEnablingInvoicing: enableState.fetchState === 'In-Progress',
+        isQboConfigured,
+        isStripeConnected,
+        status,
+    };
+};
 /**
  * Bundled view for the branding settings form: the draft `localData` (seeded
  * from the existing settings until the user edits), the business-address label

package/lib/esm/view/invoicing/subscriptionAction/subscriptionActionEpic.js

@@ -3,8 +3,9 @@ import { catchError, filter, mergeMap } from 'rxjs/operators';
 import { updateAddresses } from '../../../entity/address/addressReducer';
 import { extractInvoicingSubscriptionAddresses } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload';
 import { updateInvoicingSubscriptions } from '../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer';
+import { apiErrorSnackbarVariables } from '../../../entity/snackbar/snackbarApiError';
 import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
-import { createZeniAPIStatus, isSuccessResponse } from '../../../responsePayload';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../responsePayload';
 import { runInvoicingSubscriptionAction, runInvoicingSubscriptionActionFailure, runInvoicingSubscriptionActionSuccess, } from './subscriptionActionReducer';
 /**
  * Each lifecycle action reports with its own copy. Keyed loosely because the
@@ -24,13 +25,15 @@ export const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) =
     const { action: kind, body, id } = action.payload;
     const requestBody = { action: kind, ...(body ?? {}) };
     const snackbarSection = SNACKBAR_SECTION_BY_ACTION[kind];
-    const snackbar = (messageText) => snackbarSection == null
+    /** `status` surfaces the platform's error text; omit it to keep the generic copy. */
+    const snackbar = (messageText, status) => snackbarSection == null
         ? []
         : [
             openSnackbar({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: apiErrorSnackbarVariables(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${encodeURIComponent(id)}/actions`;
@@ -50,7 +53,7 @@ export const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) =
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), catchError((error) => from([
         runInvoicingSubscriptionActionFailure({

package/lib/esm/view/recommendation/recommendationReducer.js

@@ -134,6 +134,22 @@ const recommendation = createSlice({
         clearRecommendation(draft) {
             Object.assign(draft, initialState);
         },
+        // Fire-and-forget human feedback on a recommendation (accept, ranked
+        // override or outside override). Handled by submitRecommendationFeedbackEpic
+        // which POSTs to the accounting recommendation-feedback endpoint. No state
+        // mutation: the categorization UX must not depend on the feedback round-trip.
+        submitRecommendationFeedback: {
+            reducer(
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            _draft, 
+            // eslint-disable-next-line @typescript-eslint/no-unused-vars
+            _action) {
+                // do nothing
+            },
+            prepare(args) {
+                return { payload: args };
+            },
+        },
     },
     extraReducers: (builder) => {
         builder.addCase(clearAll, (draft) => {
@@ -141,7 +157,7 @@ const recommendation = createSlice({
         });
     },
 });
-export const { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityName, fetchRecommendationByEntityId, updateRecommendationForEntity, updateRecommendationForEntityFailure, indicateReadyToInitializeRecommendation, clearRecommendation, } = recommendation.actions;
+export const { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityName, fetchRecommendationByEntityId, updateRecommendationForEntity, updateRecommendationForEntityFailure, indicateReadyToInitializeRecommendation, clearRecommendation, submitRecommendationFeedback, } = recommendation.actions;
 export default recommendation.reducer;
 const doUpdateRecommendationForEntity = (draft, entityId, entityType, payload) => {
     const key = getEntityRecommendationKey(entityType, entityId);

package/lib/esm/view/recommendation/submitRecommendationFeedbackEpic.js

@@ -0,0 +1,52 @@
+import { EMPTY } from 'rxjs';
+import { catchError, filter, mergeMap } from 'rxjs/operators';
+import { isSuccessStatus } from '../../responsePayload';
+import { submitRecommendationFeedback } from './recommendationReducer';
+const toRequestBody = (payload) => ({
+    line_id: payload.lineId ?? null,
+    dimension: payload.dimension,
+    recommendation_set_id: payload.recommendationSetId ?? null,
+    top_pick_source: payload.topPickSource ?? null,
+    shown_recommendations: (payload.shownRecommendations ?? []).map((recommendation) => ({
+        source: recommendation.source,
+        rank: recommendation.rank,
+        value: {
+            name: recommendation.value.name,
+            id: recommendation.value.id ?? null,
+            integration_id: recommendation.value.integrationId ?? null,
+        },
+        confidence: recommendation.confidence ?? null,
+        reasoning: recommendation.reasoning ?? null,
+        cot: recommendation.cot ?? [],
+    })),
+    selected: {
+        name: payload.selected.name,
+        id: payload.selected.id ?? null,
+        integration_id: payload.selected.integrationId ?? null,
+        is_new_entity: payload.selected.isNewEntity ?? false,
+    },
+    matched_source: payload.matchedSource ?? null,
+    matched_rank: payload.matchedRank ?? null,
+    outcome: payload.outcome,
+    reason_text: payload.reasonText ?? null,
+    skipped: payload.skipped ?? false,
+    retracts_feedback_id: payload.retractsFeedbackId ?? null,
+    features: payload.features ?? null,
+});
+// Fire-and-forget: the epic never re-emits an action. Feedback delivery is a
+// side-effect that must not disrupt the categorization UX, so both the
+// success and error paths complete silently (errors are logged for debugging).
+export const submitRecommendationFeedbackEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(submitRecommendationFeedback.match), mergeMap((action) => {
+    const { transactionId } = action.payload;
+    return zeniAPI
+        .postAndGetJSON(`${zeniAPI.apiEndPoints.accountMicroServiceBaseUrl}/1.0/transactions/${transactionId}/recommendation-feedback`, toRequestBody(action.payload))
+        .pipe(mergeMap((response) => {
+        if (!isSuccessStatus(response)) {
+            console.error('submitRecommendationFeedbackEpic: recommendation feedback was not recorded', response.status);
+        }
+        return EMPTY;
+    }), catchError((error) => {
+        console.error('submitRecommendationFeedbackEpic: failed to submit recommendation feedback', error);
+        return EMPTY;
+    }));
+}));

package/lib/esm/view/vendorTabView/vendorTabViewReducer.js

@@ -53,5 +53,5 @@ const vendorTabView = createSlice({
         });
     },
 });
-export const { clearVendorTabView, fetchVendorTabView, updateVendorTabViewTab, } = vendorTabView.actions;
+export const { clearVendorTabView, fetchVendorTabView, updateVendorTabViewTab } = vendorTabView.actions;
 export default vendorTabView.reducer;

package/lib/index.d.ts

@@ -137,7 +137,7 @@ import { getTaskGroupById } from './entity/taskGroup/taskGroupSelector';
 import { TaskGroupState } from './entity/taskGroup/taskGroupState';
 import { TaskGroupTemplate } from './entity/taskGroupTemplate/taskGroupTemplateState';
 import { DoSignInPayload, deleteConnection, doMagicLinkSignIn, doSignIn, doSignOut, fetchActiveTenant, fetchAllTenants, fetchExcludedResources as fetchExcludedResourcesForTenant, fetchExternalConnections as fetchExternalConnectionsForTenant, fetchSubscriptionSummaryForTenant, initEmailConnectOAuth, resendVerifyDeviceOTP, resetSignInState, saveAPIKeyConnection, saveConnectorCredentials, saveExternalConnection as saveExternalConnectionForTenant, saveOAuthConnection, sendEmailMagicLinkToUser, sendSessionHeartbeat, toExternalIntegrationType, toExternalSupportedTool, updateCurrentTenant, updateSignInState, verifyDeviceWithTwoFA } from './entity/tenant/tenantReducer';
-import { CurrentTenant, TenantBaseView, TenantCoreDetailsView, TenantView, TenantsBaseOrdered, TenantsOrdered, DEFAULT_RECEIPTS_EMAIL, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getReceiptsEmail, getTenantBaseById, getTenantBaseViewForTenantId, getTenantBaseViewForTenantView, getTenantsBaseByCheckInDateSelector, getTenantsByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, isOtherProductsEnabledForTenant, isTenantBankingOnly, isTenantBookkeepingEnabled, isTenantCardsOnly, isTenantUsingZeniCOA, isZeniDomainTenant, toTenantCoreDetailsView } from './entity/tenant/tenantSelector';
+import { CurrentTenant, DEFAULT_RECEIPTS_EMAIL, TenantBaseView, TenantCoreDetailsView, TenantView, TenantsBaseOrdered, TenantsOrdered, getCurrentTenant, getIsAccountingClassesEnabled, getIsAccountingProjectsEnabled, getReceiptsEmail, getTenantBaseById, getTenantBaseViewForTenantId, getTenantBaseViewForTenantView, getTenantsBaseByCheckInDateSelector, getTenantsByCheckInDateSelector, getTenantsCoreDetailsByCheckInDateSelector, isOtherProductsEnabledForTenant, isTenantBankingOnly, isTenantBookkeepingEnabled, isTenantCardsOnly, isTenantUsingZeniCOA, isZeniDomainTenant, toTenantCoreDetailsView } from './entity/tenant/tenantSelector';
 import { CapitalizableAccount, CapitalizableAccounts, CapitalizableClassificationType, CapitalizableMatchPattern, Connection, LoggedInUser, RoleResource, Tenant, TenantProductSettings } from './entity/tenant/tenantState';
 import { ToastNotificationPayload } from './entity/toastNotification/toastNotificationPayload';
 import { pushToastNotification } from './entity/toastNotification/toastNotificationReducer';
@@ -393,7 +393,7 @@ import { ProfitAndLossProjectViewReport } from './view/profitAndLossProjectView/
 import { ProfitAndLossProjectViewUIState } from './view/profitAndLossProjectView/profitAndLossProjectViewState';
 import { fetchProjectList } from './view/projectList/projectListReducer';
 import { ProjectListSelectorView, getProjectList } from './view/projectList/projectListSelector';
-import { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityId, fetchRecommendationByEntityName } from './view/recommendation/recommendationReducer';
+import { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityId, fetchRecommendationByEntityName, submitRecommendationFeedback } from './view/recommendation/recommendationReducer';
 import { DEFAULT_REFERRER_AMOUNT, clearReferrals, fetchReferrals, fetchRewardsPlan, resendReferralInvite, saveReferralFormDataInLocalStore, sendReferralInvite, updateReferViewed, updateReferralListSortUiState } from './view/referralView/referralReducer';
 import { ReferralListSelectorView, RewardsPlanCardReport, getInviteFormView, getReferralListView, getRewardsPlanCard } from './view/referralView/referralSelector';
 import { AmountStatusTypes, InviteCompanyLocalData, ReferralAmountStatus, ReferralInvitation, ReferralListViewSortKey, ReferralStatus, ReferralViewState, ReferralViewUIState, RewardsPlanData, StatusTypes, toReferralListViewSortKeyType } from './view/referralView/referralState';
@@ -878,7 +878,7 @@ export { Filing1099TinType };
 export { BillPayCardReport };
 export { ReimbursementCardReport };
 export { VendorListViewSortKey, VendorViewUIState, VendorListSelectorView, VendorListQuery, getVendorList, VendorListView, updateSortUiState, updatePageToken, updateYTDSelectionUIState, VendorListViewYTDSpendSortKey, isColumnYTDSpend, isVendorsTabVisible, VendorViewType, VendorReportIDType, toVendorReportIDType, VendorFiling1099ListSelectorView, getVendorFiling1099List, VendorFiling1099ListViewSortKey, VendorFiling1099ViewUIState, VendorFiling1099DownloadData, fetchVendorsFiling1099Download, Type1099Download, VendorFiling1099DownloadDataForType, };
-export { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityId, fetchRecommendationByEntityName, };
+export { fetchEntityRecommendationsByTransactionId, fetchEntityRecommendationsForLineUpdate, fetchRecommendationByEntityId, fetchRecommendationByEntityName, submitRecommendationFeedback, };
 export type { FetchEntityRecommendationsForLineUpdatePayload, RecommendationLineUpdateFlowType, } from './view/recommendation/recommendationReducer';
 export { fetchOwnerList };
 export { ZeniAccountsConfigSelectorView, getZeniAccountsConfigDetail, ZeniAccountListSelectorView, getZeniAccountList, fetchZeniAccountList, fetchAccountList, DepositAccount, createCheckingAccount, fetchPaymentAccountList, unlinkPaymentAccount, getDepositAccountDetail, DepositAccountDetailSelectorView, DepositAccountListSelectorView, getAllDepositAccounts, getDepositAccountDetailForPDF, DepositAccountDetailForPDF, fetchDepositAccount, fetchZeniAccountsConfig, AccountHistoryWithBalances, TransferDetailLocalData, ReviewTransferDetail, updateTransferMoneyLocalData, updateTransferToLocalData, updateDepositToLocalData, transferMoney, getTransferDetail, TransferDetailSelectorView, clearTransferDetail, clearReviewTransferDetail, fetchReviewTransferDetail, fetchDepositAccountDetail, DepositAccountTransaction, DepositAccountWithAutoTransferRules, DepositTransactionStatusCode, DepositTransactionStatus, CheckDepositLocalData, depositCheck, updateCheckDepositLocalData, clearCheckDeposit, CheckDepositSelectorView, getCheckDepositDetail, updateDepositAccount, fetchDepositAccountHistorySuccess, fetchDepositAccountHistoryFailure, DepositAccountUpdateType, ZeniAccountSummaryWithBalance, fetchZeniAccStatementPage, getZeniAccStatements, ZeniAccStatementsSelectorView, ZeniAccountPaymentMethod, };
@@ -1211,8 +1211,8 @@ export { getInvoicingPlanById } from './entity/invoicing/plan/planSelector';
 export { getInvoicingProductById } from './entity/invoicing/product/productSelector';
 export type { InvoicingCatalogItemDetailView } from './view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewSelector';
 export { clearInvoicingSettings, connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
-export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
-export type { InvoicingBrandingFormView, InvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsHubView, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export type { InvoicingBrandingFormView, InvoicingSettingsHubView, InvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
 export type { InvoicingBrandingFormLocalData } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, initialInvoicingBrandingFormLocalData, } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { isStripeConnectedFromSettings } from './view/invoicing/settingsView/invoicingSettingsHelpers';