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

package/lib/view/invoicing/createCreditNote/createCreditNoteEpic.js

@@ -4,6 +4,7 @@ exports.createCreditNoteEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const creditNoteReducer_1 = require("../../../entity/invoicing/creditNote/creditNoteReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const createCreditNotePayload_1 = require("./createCreditNotePayload");
@@ -32,6 +33,7 @@ const createCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, op
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceListReducer_1 = require("../invoiceList/invoiceListReducer");
@@ -39,6 +40,7 @@ const createInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, oper
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -4,6 +4,7 @@ exports.runInvoicingDiscountActionEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const couponReducer_1 = require("../../../entity/invoicing/coupon/couponReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const discountActionReducer_1 = require("./discountActionReducer");
@@ -17,13 +18,15 @@ const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => actions$.
     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
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/discounts/${encodeURIComponent(id)}/actions`;
@@ -42,7 +45,7 @@ const runInvoicingDiscountActionEpic = (actions$, _state$, zeniAPI) => actions$.
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, discountActionReducer_1.runInvoicingDiscountActionFailure)({

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

@@ -4,6 +4,7 @@ exports.runInvoicingDunningActionEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const dunningCaseReducer_1 = require("../../../entity/invoicing/dunningCase/dunningCaseReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const dunningActionReducer_1 = require("./dunningActionReducer");
@@ -18,13 +19,15 @@ const SNACKBAR_SECTION_BY_KIND = {
 const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(dunningActionReducer_1.runInvoicingDunningAction.match), (0, operators_1.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
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/dunning/${encodeURIComponent(id)}/${kind}`;
@@ -43,7 +46,7 @@ const runInvoicingDunningActionEpic = (actions$, _state$, zeniAPI) => actions$.p
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, dunningActionReducer_1.runInvoicingDunningActionFailure)({

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

@@ -83,6 +83,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.
@@ -104,10 +106,9 @@ 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/view/invoicing/editInvoicingCatalogItemDetailView/saveInvoicingCatalogItemEpic.js

@@ -5,6 +5,7 @@ const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const planReducer_1 = require("../../../entity/invoicing/plan/planReducer");
 const productReducer_1 = require("../../../entity/invoicing/product/productReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoicingCatalogListViewReducer_1 = require("../invoicingCatalogListView/invoicingCatalogListViewReducer");
@@ -48,6 +49,7 @@ const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pip
                             messageSection: 'invoicing_catalog_item_saved',
                             messageText: 'failed',
                             type: 'error',
+                            variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(failedProductResponse.status),
                         }),
                     ]);
                 }
@@ -97,6 +99,7 @@ const saveInvoicingCatalogItemEpic = (actions$, state$, zeniAPI) => actions$.pip
                 messageSection: 'invoicing_catalog_item_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -4,6 +4,7 @@ exports.saveInvoicingCouponEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const couponReducer_1 = require("../../../entity/invoicing/coupon/couponReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const couponViewReducer_1 = require("../couponView/couponViewReducer");
@@ -60,6 +61,7 @@ const saveInvoicingCouponEpic = (actions$, state$, zeniAPI) => actions$.pipe((0,
                 messageSection: 'invoicing_coupon_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingCustomerPayload_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerPayload");
 const invoicingCustomerReducer_1 = require("../../../entity/invoicing/invoicingCustomer/invoicingCustomerReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const addressViewReducer_1 = require("../../addressView/addressViewReducer");
@@ -62,6 +63,7 @@ const saveInvoicingCustomerEpic = (actions$, state$, zeniAPI) => actions$.pipe((
                 messageSection: 'invoicing_customer_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingSubscriptionPayload_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload");
 const invoicingSubscriptionReducer_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const addressViewReducer_1 = require("../../addressView/addressViewReducer");
@@ -48,6 +49,7 @@ const saveInvoicingSubscriptionEpic = (actions$, state$, zeniAPI) => actions$.pi
                     messageSection: 'invoicing_subscription_saved',
                     messageText: 'failed',
                     type: 'error',
+                    variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
                 }),
             ];
         }

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

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicePayload_1 = require("../../../entity/invoicing/invoice/invoicePayload");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceActionReducer_1 = require("./invoiceActionReducer");
@@ -19,13 +20,15 @@ const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => actions$.p
     action.payload.action !== 'issue-credit-note'), (0, operators_1.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
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/invoices/${encodeURIComponent(invoiceId)}/${kind}`;
@@ -45,7 +48,7 @@ const runInvoicingInvoiceActionEpic = (actions$, _state$, zeniAPI) => actions$.p
                 error: response.status,
                 invoiceId,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, invoiceActionReducer_1.runInvoicingInvoiceActionFailure)({
@@ -84,6 +87,7 @@ const updateInvoicingInvoiceEpic = (actions$, _state$, zeniAPI) => actions$.pipe
                 messageSection: 'invoicing_invoice_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.retryInvoicingQboSyncTaskEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const snackbarApiError_1 = require("../../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const invoicingQboViewReducer_1 = require("../invoicingQboViewReducer");
@@ -31,6 +32,7 @@ const retryInvoicingQboSyncTaskEpic = (actions$, _state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_qbo_sync_health_retry',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.startInvoicingQboBackfillEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
+const snackbarApiError_1 = require("../../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const invoicingQboViewReducer_1 = require("../invoicingQboViewReducer");
@@ -30,6 +31,7 @@ const startInvoicingQboBackfillEpic = (actions$, _state$, zeniAPI) => actions$.p
                 messageSection: 'invoicing_qbo_backfill',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -4,6 +4,7 @@ exports.issueCreditNoteEpic = void 0;
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const creditNoteReducer_1 = require("../../../entity/invoicing/creditNote/creditNoteReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceDetailReducer_1 = require("../invoiceDetail/invoiceDetailReducer");
@@ -35,6 +36,7 @@ const issueCreditNoteEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, ope
                 messageSection: 'invoicing_credit_note_saved',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -5,6 +5,7 @@ const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const invoiceReducer_1 = require("../../../entity/invoicing/invoice/invoiceReducer");
 const invoicingTransactionReducer_1 = require("../../../entity/invoicing/invoicingTransaction/invoicingTransactionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const invoiceDetailReducer_1 = require("../invoiceDetail/invoiceDetailReducer");
@@ -43,6 +44,7 @@ const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, opera
                     messageSection: 'invoicing_payment_recorded',
                     messageText: 'failed',
                     type: 'error',
+                    variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
                 }),
             ]);
         }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
@@ -85,6 +87,7 @@ const recordPaymentEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, opera
                 messageSection: 'invoicing_payment_recorded',
                 messageText: 'failed',
                 type: 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(response.status),
             }),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([

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

@@ -4,6 +4,7 @@ exports.saveInvoicingSettingsEpic = exports.disconnectInvoicingStripeEpic = expo
 const rxjs_1 = require("rxjs");
 const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const settingsViewReducer_1 = require("./settingsViewReducer");
@@ -65,13 +66,15 @@ exports.disconnectInvoicingStripeEpic = disconnectInvoicingStripeEpic;
 const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.saveInvoicingSettings.match), (0, operators_1.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
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     return zeniAPI
@@ -85,7 +88,7 @@ const saveInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(
         }
         return (0, rxjs_1.from)([
             (0, settingsViewReducer_1.saveInvoicingSettingsFailure)(response.status),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, settingsViewReducer_1.saveInvoicingSettingsFailure)((0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save settings REST API call errored out ' +

package/lib/view/invoicing/settingsView/settingsViewSelector.d.ts

@@ -1,7 +1,8 @@
 import { FetchState, FetchStateAndError } from '../../../commonStateTypes/common';
-import { InvoicingNamedOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { RootState } from '../../../reducer';
 import { ZeniAPIStatus } from '../../../responsePayload';
+import { InvoicingOnboardingStatus } from '../invoicingConfigView/invoicingConfigViewPayload';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
 /**
  * Shared primitive: the raw invoicing settings. Consumed internally by other
@@ -27,6 +28,45 @@ export interface InvoicingSettingsView {
  * Stripe-connect fetch state.
  */
 export declare const getInvoicingSettingsView: (state: RootState) => InvoicingSettingsView;
+export interface InvoicingEnablePrerequisites {
+    canEnable: boolean;
+    isQboConfigured: boolean;
+    isStripeConnected: boolean;
+}
+/**
+ * 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 declare function deriveInvoicingEnablePrerequisites(settings: InvoicingSettingsPayload | undefined, isQboConnected: boolean, qboAccountMappingKindOptions: InvoicingQboAccountMappingKindOption[]): InvoicingEnablePrerequisites;
+export interface InvoicingSettingsHubView {
+    canEnableInvoicing: boolean;
+    isEnablingInvoicing: boolean;
+    isQboConfigured: boolean;
+    isStripeConnected: boolean;
+    status?: InvoicingOnboardingStatus;
+}
+/**
+ * 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 declare const getInvoicingSettingsHubView: (state: RootState) => InvoicingSettingsHubView;
 export interface InvoicingBrandingFormView {
     dateFormatOptions: InvoicingNamedOption[];
     localData: InvoicingBrandingFormLocalData;

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

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getInvoicingBrandingFormView = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = void 0;
+exports.getInvoicingBrandingFormView = exports.getInvoicingSettingsHubView = exports.getInvoicingSettingsView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = void 0;
+exports.deriveInvoicingEnablePrerequisites = deriveInvoicingEnablePrerequisites;
+const invoicingCommonPayload_1 = require("../../../entity/invoicing/invoicingCommonPayload");
 const addressViewSelector_1 = require("../../addressView/addressViewSelector");
 const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
@@ -36,6 +38,58 @@ const getInvoicingSettingsView = (state) => {
     };
 };
 exports.getInvoicingSettingsView = getInvoicingSettingsView;
+/**
+ * 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.
+ */
+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) => (0, invoicingCommonPayload_1.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.
+ */
+const getInvoicingSettingsHubView = (state) => {
+    const { enableState, qboAccountMappingKindOptions, status } = (0, invoicingConfigViewSelector_1.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,
+    };
+};
+exports.getInvoicingSettingsHubView = getInvoicingSettingsHubView;
 /**
  * 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/view/invoicing/subscriptionAction/subscriptionActionEpic.js

@@ -6,6 +6,7 @@ const operators_1 = require("rxjs/operators");
 const addressReducer_1 = require("../../../entity/address/addressReducer");
 const invoicingSubscriptionPayload_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionPayload");
 const invoicingSubscriptionReducer_1 = require("../../../entity/invoicing/invoicingSubscription/invoicingSubscriptionReducer");
+const snackbarApiError_1 = require("../../../entity/snackbar/snackbarApiError");
 const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
 const responsePayload_1 = require("../../../responsePayload");
 const subscriptionActionReducer_1 = require("./subscriptionActionReducer");
@@ -27,13 +28,15 @@ const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) => actio
     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
         ? []
         : [
             (0, snackbarReducer_1.openSnackbar)({
                 messageSection: snackbarSection,
                 messageText,
                 type: messageText === 'success' ? 'success' : 'error',
+                variables: (0, snackbarApiError_1.apiErrorSnackbarVariables)(status),
             }),
         ];
     const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/subscriptions/${encodeURIComponent(id)}/actions`;
@@ -53,7 +56,7 @@ const runInvoicingSubscriptionActionEpic = (actions$, _state$, zeniAPI) => actio
                 error: response.status,
                 id,
             }),
-            ...snackbar('failed'),
+            ...snackbar('failed', response.status),
         ]);
     }), (0, operators_1.catchError)((error) => (0, rxjs_1.from)([
         (0, subscriptionActionReducer_1.runInvoicingSubscriptionActionFailure)({

package/package.json

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