@zeniai/client-epic-state 5.2.10-betaAK0 → 5.2.10-betaAK2

package/lib/entity/invoicing/invoicingCommonPayload.d.ts

@@ -107,7 +107,6 @@ export interface InvoicingQboAccountMappingsPayload {
     default_income_account_id?: string | null;
     deposit_account?: Partial<AccountBasePayload> | null;
     deposit_account_id?: string | null;
-    deposit_account_overrides?: Record<string, string> | null;
     discounts_account?: Partial<AccountBasePayload> | null;
     discounts_account_id?: string | null;
     rounding_account?: Partial<AccountBasePayload> | null;
@@ -131,7 +130,20 @@ export declare const firstSelectableInvoicingId: (candidates: readonly (string |
  * Read one account-mapping dropdown value by its config `code` (the codes in
  * `qbo_account_mapping_kind_options` match the `account_mappings` field names).
  */
-export declare function getInvoicingQboAccountMappingId(accountMappings: InvoicingQboAccountMappingsPayload | undefined, code: string): string | undefined;
+export declare function getInvoicingQboAccountMappingId(accountMappings: InvoicingQboAccountMappingsPayload | undefined, code: InvoicingQboAccountMappingCode): string | undefined;
+/**
+ * Return a copy of the account mappings with the dropdown slot named by
+ * `code` set to `accountId`. Unknown codes leave the mappings unchanged.
+ */
+/** Every account-mapping slot the page can set, in the order it renders them. */
+export declare const INVOICING_QBO_ACCOUNT_MAPPING_CODES: readonly ["deposit_account_id", "default_income_account_id", "discounts_account_id", "rounding_account_id", "write_off_account_id"];
+export type InvoicingQboAccountMappingCode = (typeof INVOICING_QBO_ACCOUNT_MAPPING_CODES)[number];
+/**
+ * Narrows a mapping code that arrived from the config API. Anything the client
+ * has no slot for returns undefined rather than being cast through: a code we
+ * cannot place is a mapping we cannot read or write.
+ */
+export declare const toInvoicingQboAccountMappingCode: (code: string) => InvoicingQboAccountMappingCode | undefined;
 /**
  * Expand each mapping from the id the picker submitted to the whole account, the
  * shape the service stores. Written at the request boundary rather than in the
@@ -139,7 +151,7 @@ export declare function getInvoicingQboAccountMappingId(accountMappings: Invoici
  * is left out — a mapping the service cannot expand is worse than none.
  */
 export declare const withInvoicingQboMappedAccounts: (accountMappings: InvoicingQboAccountMappingsPayload | undefined, accountByQboId: (qboId: string) => AccountBase | undefined) => InvoicingQboAccountMappingsPayload | undefined;
-export declare function withInvoicingQboAccountMappingId(accountMappings: InvoicingQboAccountMappingsPayload | undefined, code: string, accountId: string): InvoicingQboAccountMappingsPayload;
+export declare function withInvoicingQboAccountMappingId(accountMappings: InvoicingQboAccountMappingsPayload | undefined, code: InvoicingQboAccountMappingCode, accountId: string): InvoicingQboAccountMappingsPayload;
 export interface InvoicingQboSettingsPayload {
     account_mappings?: InvoicingQboAccountMappingsPayload | null;
     auto_create_items?: boolean;

package/lib/entity/invoicing/invoicingCommonPayload.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ALL_INVOICING_FIELD_HELP_GROUPS = exports.withInvoicingQboMappedAccounts = exports.firstSelectableInvoicingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.INVOICING_DISCOUNT_LIFECYCLE_ACTIONS = exports.INVOICING_CATALOG_PRODUCT_LIFECYCLE_ACTIONS = exports.INVOICING_CATALOG_ITEM_LIFECYCLE_ACTIONS = exports.INVOICING_SUBSCRIPTION_LIFECYCLE_ACTIONS = exports.INVOICING_DUNNING_ACTIONS = void 0;
+exports.ALL_INVOICING_FIELD_HELP_GROUPS = exports.withInvoicingQboMappedAccounts = exports.toInvoicingQboAccountMappingCode = exports.INVOICING_QBO_ACCOUNT_MAPPING_CODES = exports.firstSelectableInvoicingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.INVOICING_DISCOUNT_LIFECYCLE_ACTIONS = exports.INVOICING_CATALOG_PRODUCT_LIFECYCLE_ACTIONS = exports.INVOICING_CATALOG_ITEM_LIFECYCLE_ACTIONS = exports.INVOICING_SUBSCRIPTION_LIFECYCLE_ACTIONS = exports.INVOICING_DUNNING_ACTIONS = void 0;
 exports.toInvoicingDunningAction = toInvoicingDunningAction;
 exports.toInvoicingSubscriptionLifecycleAction = toInvoicingSubscriptionLifecycleAction;
 exports.toInvoicingSubscriptionLifecycleActionOption = toInvoicingSubscriptionLifecycleActionOption;
@@ -200,6 +200,21 @@ function getInvoicingQboAccountMappingId(accountMappings, code) {
  * Return a copy of the account mappings with the dropdown slot named by
  * `code` set to `accountId`. Unknown codes leave the mappings unchanged.
  */
+/** Every account-mapping slot the page can set, in the order it renders them. */
+exports.INVOICING_QBO_ACCOUNT_MAPPING_CODES = [
+    'deposit_account_id',
+    'default_income_account_id',
+    'discounts_account_id',
+    'rounding_account_id',
+    'write_off_account_id',
+];
+/**
+ * Narrows a mapping code that arrived from the config API. Anything the client
+ * has no slot for returns undefined rather than being cast through: a code we
+ * cannot place is a mapping we cannot read or write.
+ */
+const toInvoicingQboAccountMappingCode = (code) => exports.INVOICING_QBO_ACCOUNT_MAPPING_CODES.find((knownCode) => knownCode === code);
+exports.toInvoicingQboAccountMappingCode = toInvoicingQboAccountMappingCode;
 /** The object key holding the mapped account for each `*_account_id` code. */
 const INVOICING_QBO_MAPPED_ACCOUNT_KEY = {
     default_income_account_id: 'default_income_account',
@@ -219,7 +234,8 @@ const withInvoicingQboMappedAccounts = (accountMappings, accountByQboId) => {
         return undefined;
     }
     const expanded = { ...accountMappings };
-    Object.entries(INVOICING_QBO_MAPPED_ACCOUNT_KEY).forEach(([code, objectKey]) => {
+    exports.INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const objectKey = INVOICING_QBO_MAPPED_ACCOUNT_KEY[code];
         const accountId = getInvoicingQboAccountMappingId(accountMappings, code);
         if (accountId == null) {
             return;

package/lib/epic.d.ts

@@ -265,7 +265,7 @@ import { ActionType as InvoicingTransactionListViewActionType } from './view/inv
 import { ActionType as InvoicingPaymentActionActionType } from './view/invoicing/paymentAction/paymentActionEpic';
 import { ActionType as InvoicingPromotionalCreditActionActionType } from './view/invoicing/promotionalCreditAction/promotionalCreditActionEpic';
 import { ActionType as RecordPaymentActionType } from './view/invoicing/recordPayment/recordPaymentEpic';
-import { ActionType as InvoicingSettingsViewActionType } from './view/invoicing/settingsView/settingsViewEpics';
+import { InvoicingSettingsViewActionType } from './view/invoicing/settingsView/epics/settingsViewActionType';
 import { ActionType as InvoicingSubscriptionActionActionType } from './view/invoicing/subscriptionAction/subscriptionActionEpic';
 import { ActionType as FetchMonthClosePerformanceTrendActionType } from './view/monthEndCloseChecksView/epics/fetchMonthClosePerformanceTrendEpic';
 import { ActionType as FetchMonthEndCloseChecksActionType } from './view/monthEndCloseChecksView/epics/fetchMonthEndCloseChecksEpic';

package/lib/epic.js

@@ -313,8 +313,12 @@ const issueCreditNoteEpic_1 = require("./view/invoicing/issueCreditNote/issueCre
 const paymentActionEpic_1 = require("./view/invoicing/paymentAction/paymentActionEpic");
 const promotionalCreditActionEpic_1 = require("./view/invoicing/promotionalCreditAction/promotionalCreditActionEpic");
 const recordPaymentEpic_1 = require("./view/invoicing/recordPayment/recordPaymentEpic");
+const connectInvoicingStripeEpic_1 = require("./view/invoicing/settingsView/epics/connectInvoicingStripeEpic");
+const disconnectInvoicingStripeEpic_1 = require("./view/invoicing/settingsView/epics/disconnectInvoicingStripeEpic");
+const fetchInvoicingSettingsEpic_1 = require("./view/invoicing/settingsView/epics/fetchInvoicingSettingsEpic");
+const saveInvoicingSettingsEpic_1 = require("./view/invoicing/settingsView/epics/saveInvoicingSettingsEpic");
+const submitInvoicingQboSettingsEpic_1 = require("./view/invoicing/settingsView/epics/submitInvoicingQboSettingsEpic");
 const invoicingBrandingFormEpics_1 = require("./view/invoicing/settingsView/invoicingBrandingFormEpics");
-const settingsViewEpics_1 = require("./view/invoicing/settingsView/settingsViewEpics");
 const subscriptionActionEpic_1 = require("./view/invoicing/subscriptionAction/subscriptionActionEpic");
 const fetchMonthClosePerformanceTrendEpic_1 = require("./view/monthEndCloseChecksView/epics/fetchMonthClosePerformanceTrendEpic");
 const fetchMonthEndCloseChecksEpic_1 = require("./view/monthEndCloseChecksView/epics/fetchMonthEndCloseChecksEpic");
@@ -762,7 +766,7 @@ const ALL_EPICS = [
     confirmBulkUploadMatchEpic_1.confirmBulkUploadMatchEpic,
     confirmCardSetupIntentEpic_1.confirmCardSetupIntentEpic,
     confirmStatementMappingEpic_1.confirmStatementMappingEpic,
-    settingsViewEpics_1.connectInvoicingStripeEpic,
+    connectInvoicingStripeEpic_1.connectInvoicingStripeEpic,
     convertAmountToHomeCurrencyEpic_1.convertAmountToHomeCurrencyEpic,
     createAddressEpic_1.createAddressEpic,
     createAutoTransferRuleEpic_1.createAutoTransferRuleEpic,
@@ -814,7 +818,7 @@ const ALL_EPICS = [
     deleteTransactionAttachmentEpic_1.deleteTransactionAttachmentEpic,
     deleteUserBankAccountEpic_1.deleteUserBankAccountEpic,
     disableAccountingProjectsEpic_1.disableAccountingProjectsEpic,
-    settingsViewEpics_1.disconnectInvoicingStripeEpic,
+    disconnectInvoicingStripeEpic_1.disconnectInvoicingStripeEpic,
     dismissCapitalizationOnboardingEpic_1.dismissCapitalizationOnboardingEpic,
     doMagicLinkSignInEpic_1.doMagicLinkSignInEpic,
     signInUserEpic_1.doSignInEpic,
@@ -1023,7 +1027,7 @@ const ALL_EPICS = [
     customerPaymentMethodEpic_1.fetchInvoicingPlaidLinkTokenEpic,
     fetchInvoicingQboConnectionEpic_1.fetchInvoicingQboConnectionEpic,
     fetchInvoicingQboSyncHealthEpic_1.fetchInvoicingQboSyncHealthEpic,
-    settingsViewEpics_1.fetchInvoicingSettingsEpic,
+    fetchInvoicingSettingsEpic_1.fetchInvoicingSettingsEpic,
     fetchInvoicingSubscriptionCountsEpic_1.fetchInvoicingSubscriptionCountsEpic,
     invoicingSubscriptionDetailViewEpics_1.fetchInvoicingSubscriptionDetailEpic,
     fetchInvoicingSubscriptionFormPageEpic_1.fetchInvoicingSubscriptionFormPageEpic,
@@ -1311,7 +1315,7 @@ const ALL_EPICS = [
     saveInvoicingCouponEpic_1.saveInvoicingCouponEpic,
     saveInvoicingCustomerEpic_1.saveInvoicingCustomerEpic,
     customerPaymentMethodEpic_1.saveInvoicingPaymentMethodEpic,
-    settingsViewEpics_1.saveInvoicingSettingsEpic,
+    saveInvoicingSettingsEpic_1.saveInvoicingSettingsEpic,
     saveInvoicingSubscriptionEpic_1.saveInvoicingSubscriptionEpic,
     saveMagicLinkBankAccountEpic_1.saveMagicLinkBankAccountEpic,
     saveNewAddressEpic_1.saveNewAddressEpic,
@@ -1360,6 +1364,7 @@ const ALL_EPICS = [
     submitFeedbackEpic_1.submitFeedbackEpic,
     submitIntlVerificationEpic_1.submitIntlVerificationEpic,
     invoicingBrandingFormEpics_1.submitInvoicingBrandingFormEpic,
+    submitInvoicingQboSettingsEpic_1.submitInvoicingQboSettingsEpic,
     submitQuestionEpic_1.submitQuestionEpic,
     syncInvoicingSubscriptionCouponsEpic_1.syncInvoicingSubscriptionCouponsEpic,
     syncTabsAfterAutomatchEpic_1.syncTabsAfterAutomatchEpic,

package/lib/esm/entity/invoicing/invoicingCommonPayload.js

@@ -174,6 +174,20 @@ export function getInvoicingQboAccountMappingId(accountMappings, code) {
  * Return a copy of the account mappings with the dropdown slot named by
  * `code` set to `accountId`. Unknown codes leave the mappings unchanged.
  */
+/** Every account-mapping slot the page can set, in the order it renders them. */
+export const INVOICING_QBO_ACCOUNT_MAPPING_CODES = [
+    'deposit_account_id',
+    'default_income_account_id',
+    'discounts_account_id',
+    'rounding_account_id',
+    'write_off_account_id',
+];
+/**
+ * Narrows a mapping code that arrived from the config API. Anything the client
+ * has no slot for returns undefined rather than being cast through: a code we
+ * cannot place is a mapping we cannot read or write.
+ */
+export const toInvoicingQboAccountMappingCode = (code) => INVOICING_QBO_ACCOUNT_MAPPING_CODES.find((knownCode) => knownCode === code);
 /** The object key holding the mapped account for each `*_account_id` code. */
 const INVOICING_QBO_MAPPED_ACCOUNT_KEY = {
     default_income_account_id: 'default_income_account',
@@ -193,7 +207,8 @@ export const withInvoicingQboMappedAccounts = (accountMappings, accountByQboId)
         return undefined;
     }
     const expanded = { ...accountMappings };
-    Object.entries(INVOICING_QBO_MAPPED_ACCOUNT_KEY).forEach(([code, objectKey]) => {
+    INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const objectKey = INVOICING_QBO_MAPPED_ACCOUNT_KEY[code];
         const accountId = getInvoicingQboAccountMappingId(accountMappings, code);
         if (accountId == null) {
             return;

package/lib/esm/epic.js

@@ -310,8 +310,12 @@ import { issueCreditNoteEpic } from './view/invoicing/issueCreditNote/issueCredi
 import { runInvoicingPaymentActionEpic, } from './view/invoicing/paymentAction/paymentActionEpic';
 import { addPromotionalCreditsEpic, } from './view/invoicing/promotionalCreditAction/promotionalCreditActionEpic';
 import { recordPaymentEpic, } from './view/invoicing/recordPayment/recordPaymentEpic';
+import { connectInvoicingStripeEpic } from './view/invoicing/settingsView/epics/connectInvoicingStripeEpic';
+import { disconnectInvoicingStripeEpic } from './view/invoicing/settingsView/epics/disconnectInvoicingStripeEpic';
+import { fetchInvoicingSettingsEpic } from './view/invoicing/settingsView/epics/fetchInvoicingSettingsEpic';
+import { saveInvoicingSettingsEpic } from './view/invoicing/settingsView/epics/saveInvoicingSettingsEpic';
+import { submitInvoicingQboSettingsEpic } from './view/invoicing/settingsView/epics/submitInvoicingQboSettingsEpic';
 import { initializeInvoicingBrandingAddressEpic, submitInvoicingBrandingFormEpic, } from './view/invoicing/settingsView/invoicingBrandingFormEpics';
-import { connectInvoicingStripeEpic, disconnectInvoicingStripeEpic, fetchInvoicingSettingsEpic, saveInvoicingSettingsEpic, } from './view/invoicing/settingsView/settingsViewEpics';
 import { runInvoicingSubscriptionActionEpic, } from './view/invoicing/subscriptionAction/subscriptionActionEpic';
 import { fetchMonthClosePerformanceTrendEpic, } from './view/monthEndCloseChecksView/epics/fetchMonthClosePerformanceTrendEpic';
 import { fetchMonthEndCloseChecksEpic, } from './view/monthEndCloseChecksView/epics/fetchMonthEndCloseChecksEpic';
@@ -1357,6 +1361,7 @@ const ALL_EPICS = [
     submitFeedbackEpic,
     submitIntlVerificationEpic,
     submitInvoicingBrandingFormEpic,
+    submitInvoicingQboSettingsEpic,
     submitQuestionEpic,
     syncInvoicingSubscriptionCouponsEpic,
     syncTabsAfterAutomatchEpic,

package/lib/esm/index.js

@@ -194,11 +194,11 @@ import { getExpenseAutomationTransactionView, getLastTransferEntryReplacement, }
 import { applyTransactionFilters } from './view/expenseAutomationView/transactionFilterHelpers';
 import { TRANSACTION_FILTER_CATEGORIES, } from './view/expenseAutomationView/transactionFilterTypes';
 import { DEFAULT_COMPLETED_SUB_TAB, toCompletedSubTab, } from './view/expenseAutomationView/types/completedSubTab';
-import { DEFAULT_TRANSACTION_GROUP, TRANSACTION_GROUPS, toTransactionGroup, } from './view/expenseAutomationView/types/transactionGroup';
 import { toJEScheduleMainTab as toExpenseAutomationJEScheduleMainTab, toJEScheduleSortKey as toExpenseAutomationJEScheduleSortKey, } from './view/expenseAutomationView/types/jeSchedulesViewState';
 import { BATCH_FILE_STATUSES, isUnmatchedTabFileStatus, toBatchFileStatus, toBatchStatusValue, toBulkUploadPhase, toBulkUploadResultsTab, toBulkUploadSortKey, toMatchSource, toMissingReceiptsTab, } from './view/expenseAutomationView/types/missingReceiptsViewState';
 import { toMissingReceiptsSortKey as toExpenseAutomationMissingReceiptsSortKey, } from './view/expenseAutomationView/types/missingReceiptsViewState';
 import { toReconciliationTabsType, } from './view/expenseAutomationView/types/reconciliationViewState';
+import { DEFAULT_TRANSACTION_GROUP, TRANSACTION_GROUPS, toTransactionGroup, } from './view/expenseAutomationView/types/transactionGroup';
 import { toTransactionsTabKey as toExpenseAutomationTransactionsTabKey, toTransactionsSortKey, } from './view/expenseAutomationView/types/transactionsViewState';
 import { fetchRegisteredInterests, notifyMeForFeature, } from './view/featureNotificationView/featureNotificationViewReducer';
 import { getFeatureNotificationView, getRegisteredInterests, getRegisteredInterestsByFeature, isFeatureInterestRegistered, } from './view/featureNotificationView/featureNotificationViewSelector';
@@ -849,8 +849,10 @@ export { getInvoicingCatalogItemDetail } from './view/invoicing/invoicingCatalog
 export { getInvoicingPlanById } from './entity/invoicing/plan/planSelector';
 export { getInvoicingProductById } from './entity/invoicing/product/productSelector';
 // ── Invoicing: settings ───────────────────────────────────────────────────────
-export { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
-export { getInvoicingBrandingFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsHubView, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetInvoicingQboSettingsDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, submitInvoicingQboSettings, updateInvoicingBrandingFormDraft, updateInvoicingQboSettingsDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
+export { getInvoicingBrandingFormView, getInvoicingQboSettingsFormView, getInvoicingSettings, getInvoicingSettingsFetchState, getInvoicingSettingsHubView, getInvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
+export { INVOICING_QBO_ACCOUNT_MAPPING_CODES, toInvoicingQboAccountMappingCode, } from './entity/invoicing/invoicingCommonPayload';
+export { entityToInvoicingQboSettingsLocalData, initialInvoicingQboSettingsLocalData, invoicingQboSettingsLocalDataToPayload, } from './view/invoicing/settingsView/invoicingQboSettingsFormConfig';
 export { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, initialInvoicingBrandingFormLocalData, } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
 export { isStripeConnectedFromSettings } from './view/invoicing/settingsView/invoicingSettingsHelpers';
 // ── Invoicing: QBO integration ────────────────────────────────────────────────

package/lib/esm/view/invoicing/invoicingQboView/invoicingQboViewSelector.js

@@ -46,16 +46,30 @@ export const invoicingQboAccountByQboId = (state, qboId) => {
     if (qboId == null || qboId === '') {
         return undefined;
     }
-    const { accounts } = getAccountList(state.accountState, state.accountListState, INVOICING_ACCOUNT_LIST_KEY);
-    return accounts.find((account) => String(account.qboId) === qboId);
+    // `getAccountList` throws when a listed id is missing from the entity slice.
+    // That is survivable when looking one account up — the caller falls back to
+    // the id it already had — but not when it happens inside an epic, where the
+    // throw would take the whole request with it.
+    try {
+        const { accounts } = getAccountList(state.accountState, state.accountListState, INVOICING_ACCOUNT_LIST_KEY);
+        return accounts.find((account) => String(account.qboId) === qboId);
+    }
+    catch {
+        return undefined;
+    }
 };
 /** The class behind a picker value, for the same reason as the account above. */
 export const invoicingQboClassByQboId = (state, qboId) => {
     if (qboId == null || qboId === '') {
         return undefined;
     }
-    const { classes } = getClassList(state.classState, state.classListState);
-    return classes.find((accountingClass) => String(accountingClass.qboId) === qboId);
+    try {
+        const { classes } = getClassList(state.classState, state.classListState);
+        return classes.find((accountingClass) => String(accountingClass.qboId) === qboId);
+    }
+    catch {
+        return undefined;
+    }
 };
 /**
  * Accounts and classes as the invoicing pickers need them. Both come from the

package/lib/esm/view/invoicing/settingsView/epics/connectInvoicingStripeEpic.js

@@ -0,0 +1,27 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { connectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, updateInvoicingStripeConnection, } from '../settingsViewReducer';
+export const connectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(connectInvoicingStripe.match), mergeMap((action) => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings/stripe-connect/setup`;
+    const { api_key, publishable_key, webhook_secret } = action.payload;
+    const body = {
+        api_key,
+        publishable_key,
+        ...(webhook_secret != null && webhook_secret !== ''
+            ? { webhook_secret }
+            : {}),
+    };
+    return zeniAPI
+        .postAndGetJSON(apiUrl, body)
+        .pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return of(updateInvoicingStripeConnection({
+                stripe_connected: response.data.stripe_connected,
+                publishable_key: response.data.publishable_key,
+            }), fetchInvoicingSettings());
+        }
+        return of(invoicingStripeConnectionFailure(response.status));
+    }), catchError((error) => of(invoicingStripeConnectionFailure(createZeniAPIStatus('Unexpected Error', 'Stripe connect setup REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/settingsView/epics/disconnectInvoicingStripeEpic.js

@@ -0,0 +1,24 @@
+import { of } from 'rxjs';
+import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, updateInvoicingStripeConnection, } from '../settingsViewReducer';
+export const disconnectInvoicingStripeEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(disconnectInvoicingStripe.match), mergeMap(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings/stripe-connect/callback`;
+    return zeniAPI
+        .deleteAndGetJSON(apiUrl)
+        .pipe(switchMap((response) => {
+        if (isSuccessResponse(response)) {
+            return of(updateInvoicingStripeConnection({
+                stripe_connected: false,
+                publishable_key: '',
+            }), fetchInvoicingSettings());
+        }
+        return of(invoicingStripeConnectionFailure(response.status));
+    }), catchError((error) => of(invoicingStripeConnectionFailure(createZeniAPIStatus('Unexpected Error', 'Stripe disconnect REST API call errored out ' +
+        JSON.stringify(error))))));
+}));
+/**
+ * Turns the QBO settings draft into a save. The draft lives in the store, so the
+ * screen fires one action and this reads what to send — the values do not have
+ * to travel back out through the page's props to get here.
+ */

package/lib/esm/view/invoicing/settingsView/epics/fetchInvoicingSettingsEpic.js

@@ -0,0 +1,19 @@
+import { of } from 'rxjs';
+import { catchError, filter, switchMap } from 'rxjs/operators';
+import { updateAddresses } from '../../../../entity/address/addressReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { fetchInvoicingSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, } from '../settingsViewReducer';
+export const fetchInvoicingSettingsEpic = (actions$, _state$, zeniAPI) => actions$.pipe(filter(fetchInvoicingSettings.match), switchMap(() => {
+    const apiUrl = `${zeniAPI.apiEndPoints.invoicingMicroServiceBaseUrl}/1.0/settings`;
+    return zeniAPI.getJSON(apiUrl).pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            const address = response.data.address;
+            return [
+                ...(address != null ? [updateAddresses([address])] : []),
+                updateInvoicingSettings(response.data),
+            ];
+        }
+        return of(updateInvoicingSettingsFailure(response.status));
+    }), catchError((error) => of(updateInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Fetch settings REST API call errored out ' +
+        JSON.stringify(error))))));
+}));

package/lib/esm/view/invoicing/settingsView/epics/saveInvoicingSettingsEpic.js

@@ -0,0 +1,54 @@
+import { from } from 'rxjs';
+import { catchError, filter, mergeMap, switchMap } from 'rxjs/operators';
+import { withInvoicingQboMappedAccounts, } from '../../../../entity/invoicing/invoicingCommonPayload';
+import { apiErrorSnackbarVariables } from '../../../../entity/snackbar/snackbarApiError';
+import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
+import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
+import { invoicingQboAccountByQboId } from '../../invoicingQboView/invoicingQboViewSelector';
+import { saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, } from '../settingsViewReducer';
+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;
+    // The QBO page edits mappings as picker ids; the service stores whole
+    // accounts. Expanded here, at the request boundary, so the page does not
+    // have to hold entities it only needs in order to save.
+    const qboSettings = settings.qbo;
+    const body = qboSettings?.account_mappings != null
+        ? {
+            ...settings,
+            qbo: {
+                ...qboSettings,
+                account_mappings: withInvoicingQboMappedAccounts(qboSettings.account_mappings, (qboId) => invoicingQboAccountByQboId(state$.value, qboId)),
+            },
+        }
+        : settings;
+    /** `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
+        .putAndGetJSON(apiUrl, { ...body })
+        .pipe(switchMap((response) => {
+        if (isSuccessResponse(response) && response.data != null) {
+            return from([
+                saveInvoicingSettingsSuccess(response.data),
+                ...snackbar('success'),
+            ]);
+        }
+        return from([
+            saveInvoicingSettingsFailure(response.status),
+            ...snackbar('failed', response.status),
+        ]);
+    }), catchError((error) => from([
+        saveInvoicingSettingsFailure(createZeniAPIStatus('Unexpected Error', 'Save settings REST API call errored out ' +
+            JSON.stringify(error))),
+        ...snackbar('failed'),
+    ])));
+}));

package/lib/esm/view/invoicing/settingsView/epics/settingsViewActionType.js

@@ -0,0 +1 @@
+export {};

package/lib/esm/view/invoicing/settingsView/epics/submitInvoicingQboSettingsEpic.js

@@ -0,0 +1,22 @@
+import { EMPTY, of } from 'rxjs';
+import { filter, mergeMap, withLatestFrom } from 'rxjs/operators';
+import { invoicingQboSettingsLocalDataToPayload } from '../invoicingQboSettingsFormConfig';
+import { saveInvoicingSettings, submitInvoicingQboSettings, } from '../settingsViewReducer';
+/**
+ * Saves the QBO local data. The screen fires this without a payload — the local
+ * data is already in the store, so sending it back through the action would make
+ * the page the carrier for state it does not own. Converting to the request body
+ * happens here too, keeping the wire shape out of the screen.
+ */
+export const submitInvoicingQboSettingsEpic = (actions$, state$) => actions$.pipe(filter(submitInvoicingQboSettings.match), withLatestFrom(state$), mergeMap(([, state]) => {
+    const { qboDraft } = state.invoicingSettingsViewState;
+    // No local data means the settings response has not landed, so there is
+    // nothing the user could have edited yet.
+    if (qboDraft == null) {
+        return EMPTY;
+    }
+    return of(saveInvoicingSettings({
+        settings: { qbo: invoicingQboSettingsLocalDataToPayload(qboDraft) },
+        snackbarSection: 'invoicing_qbo_settings_save',
+    }));
+}));

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

@@ -0,0 +1,52 @@
+import { INVOICING_QBO_ACCOUNT_MAPPING_CODES, getInvoicingQboAccountMappingId, withInvoicingQboAccountMappingId, } from '../../../entity/invoicing/invoicingCommonPayload';
+export const initialInvoicingQboSettingsLocalData = {
+    accountIdByMappingCode: {},
+    autoCreateItems: false,
+    closedPeriodVoidAsCreditMemo: false,
+    customerMatching: '',
+    isSyncEnabled: false,
+    syncStartDate: '',
+    trackingCategoriesEnabled: false,
+};
+/** The settings response as the page edits it. */
+export const entityToInvoicingQboSettingsLocalData = (qbo) => {
+    const accountIdByMappingCode = {};
+    INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const accountId = getInvoicingQboAccountMappingId(qbo?.account_mappings ?? undefined, code);
+        if (accountId != null) {
+            accountIdByMappingCode[code] = accountId;
+        }
+    });
+    return {
+        accountIdByMappingCode,
+        autoCreateItems: qbo?.auto_create_items === true,
+        closedPeriodVoidAsCreditMemo: qbo?.closed_period_void_as_credit_memo === true,
+        customerMatching: qbo?.customer_matching ?? '',
+        isSyncEnabled: qbo?.enabled === true,
+        syncStartDate: qbo?.sync_start_date ?? '',
+        trackingCategoriesEnabled: qbo?.tracking_categories_enabled === true,
+    };
+};
+/**
+ * The local data as the request body. Only the mappings the page holds are sent;
+ * an empty id means the slot was never set, so it is left out rather than sent
+ * blank.
+ */
+export const invoicingQboSettingsLocalDataToPayload = (localData) => {
+    let accountMappings = {};
+    INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const accountId = localData.accountIdByMappingCode[code] ?? '';
+        if (accountId !== '') {
+            accountMappings = withInvoicingQboAccountMappingId(accountMappings, code, accountId);
+        }
+    });
+    return {
+        account_mappings: accountMappings,
+        auto_create_items: localData.autoCreateItems,
+        closed_period_void_as_credit_memo: localData.closedPeriodVoidAsCreditMemo,
+        customer_matching: localData.customerMatching,
+        enabled: localData.isSyncEnabled,
+        sync_start_date: localData.syncStartDate !== '' ? localData.syncStartDate : null,
+        tracking_categories_enabled: localData.trackingCategoriesEnabled,
+    };
+};

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

@@ -1,5 +1,6 @@
 import { createSlice } from '@reduxjs/toolkit';
 import { clearAll } from '../../../rootActions';
+import { entityToInvoicingQboSettingsLocalData, } from './invoicingQboSettingsFormConfig';
 export const initialState = {
     fetchState: 'Not-Started',
     error: undefined,
@@ -22,6 +23,11 @@ const settingsView = createSlice({
             draft.settings = action.payload;
             draft.fetchState = 'Completed';
             draft.error = undefined;
+            // Seed the QBO page's local data from the response. An edit already in
+            // progress wins: a refetch behind the user must not discard it.
+            if (draft.qboDraft == null) {
+                draft.qboDraft = entityToInvoicingQboSettingsLocalData(action.payload.qbo);
+            }
         },
         updateInvoicingSettingsFailure(draft, action) {
             draft.fetchState = 'Error';
@@ -36,6 +42,9 @@ const settingsView = createSlice({
         saveInvoicingSettingsSuccess(draft, action) {
             draft.settings = action.payload;
             draft.saveFetchState = { fetchState: 'Completed', error: undefined };
+            // Re-seeded from what was just persisted, so the page keeps working off
+            // local data while showing the server's version of it.
+            draft.qboDraft = entityToInvoicingQboSettingsLocalData(action.payload.qbo);
         },
         saveInvoicingSettingsFailure(draft, action) {
             draft.saveFetchState = { fetchState: 'Error', error: action.payload };
@@ -54,6 +63,17 @@ const settingsView = createSlice({
         resetInvoicingBrandingFormDraft(draft) {
             draft.brandingDraft = undefined;
         },
+        updateInvoicingQboSettingsDraft(draft, action) {
+            draft.qboDraft = action.payload.localData;
+        },
+        // Trigger only — handled by submitInvoicingQboSettingsEpic, which reads the
+        // local data and converts it to the request body.
+        submitInvoicingQboSettings(draft) {
+            draft.saveFetchState = { fetchState: 'In-Progress', error: undefined };
+        },
+        resetInvoicingQboSettingsDraft(draft) {
+            draft.qboDraft = undefined;
+        },
         connectInvoicingStripe: {
             reducer(draft) {
                 draft.stripeFetchState = { fetchState: 'In-Progress', error: undefined };
@@ -85,5 +105,5 @@ const settingsView = createSlice({
         });
     },
 });
-export const { fetchInvoicingSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, saveInvoicingSettings, saveInvoicingSettingsSuccess, saveInvoicingSettingsFailure, resetSaveInvoicingSettings, updateInvoicingBrandingFormDraft, submitInvoicingBrandingForm, resetInvoicingBrandingFormDraft, connectInvoicingStripe, disconnectInvoicingStripe, updateInvoicingStripeConnection, invoicingStripeConnectionFailure, } = settingsView.actions;
+export const { fetchInvoicingSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, saveInvoicingSettings, saveInvoicingSettingsSuccess, saveInvoicingSettingsFailure, resetSaveInvoicingSettings, updateInvoicingBrandingFormDraft, submitInvoicingBrandingForm, resetInvoicingBrandingFormDraft, updateInvoicingQboSettingsDraft, submitInvoicingQboSettings, resetInvoicingQboSettingsDraft, connectInvoicingStripe, disconnectInvoicingStripe, updateInvoicingStripeConnection, invoicingStripeConnectionFailure, } = settingsView.actions;
 export default settingsView.reducer;

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

@@ -1,7 +1,9 @@
-import { getInvoicingQboAccountMappingId, } from '../../../entity/invoicing/invoicingCommonPayload';
+import { getInvoicingQboAccountMappingId, toInvoicingQboAccountMappingCode, } from '../../../entity/invoicing/invoicingCommonPayload';
 import { getFormattedAddress } from '../../addressView/addressViewSelector';
 import { getInvoicingConfigView } from '../invoicingConfigView/invoicingConfigViewSelector';
+import { getInvoicingQboView, isInvoicingAccountingPickerDataLoading, } from '../invoicingQboView/invoicingQboViewSelector';
 import { INVOICING_BUSINESS_ADDRESS_TYPE, entityToInvoicingBrandingFormLocalData, } from './invoicingBrandingFormConfig';
+import { initialInvoicingQboSettingsLocalData, } from './invoicingQboSettingsFormConfig';
 /**
  * Shared primitive: the raw invoicing settings. Consumed internally by other
  * CES selectors (create-invoice, customer-detail, overview) and by non-settings
@@ -50,7 +52,12 @@ export function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qbo
     // 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);
+        qboAccountMappingKindOptions.every((option) => {
+            // A kind the client has no slot for cannot count as configured.
+            const code = toInvoicingQboAccountMappingCode(option.code);
+            return (code != null &&
+                getInvoicingQboAccountMappingId(accountMappings, code) != null);
+        });
     return {
         canEnable: isStripeConnected && isQboConfigured,
         isQboConfigured,
@@ -92,6 +99,45 @@ export const getInvoicingSettingsHubView = (state) => {
         status,
     };
 };
+/**
+ * Bundled view for the QBO configuration page: the draft it edits, the accounts
+ * and option lists its dropdowns render, the connection and sync health it
+ * reports, and the fetch states that decide between skeleton, form and error.
+ *
+ * `localData` is the draft once the user has edited, and the settings response
+ * before that — so the page has one field to read and CES owns when it becomes
+ * available, rather than the page copying settings into local state.
+ */
+export const getInvoicingQboSettingsFormView = (state) => {
+    const { error, fetchState, qboDraft, saveFetchState, settings } = state.invoicingSettingsViewState;
+    const { fetchState: configFetchState, qboAccountMappingKindOptions, qboCustomerMatchingOptions, qboSyncStatusOptions, } = getInvoicingConfigView(state);
+    const qboView = getInvoicingQboView(state);
+    return {
+        accountMappingKindOptions: qboAccountMappingKindOptions,
+        accounts: qboView.accounts,
+        backfillState: qboView.backfillState,
+        connection: qboView.connection,
+        configFetchState,
+        customerMatchingOptions: qboCustomerMatchingOptions,
+        // The dropdowns cannot be built before both the settings and the accounts
+        // land, so the page waits on either rather than rendering empty pickers.
+        isLoading: fetchState === 'Not-Started' ||
+            fetchState === 'In-Progress' ||
+            isInvoicingAccountingPickerDataLoading(state),
+        isSyncEnabledSaved: settings?.qbo?.enabled === true,
+        // Seeded in the reducer when the settings response lands, so this is a plain
+        // read rather than a second place that decides what the page starts from.
+        localData: qboDraft ?? initialInvoicingQboSettingsLocalData,
+        nestedAccountHierarchy: qboView.nestedAccountHierarchy,
+        retryFetchStateByTaskId: qboView.retryFetchStateByTaskId,
+        saveState: saveFetchState.fetchState === 'Not-Started' && error != null
+            ? { fetchState, error }
+            : saveFetchState,
+        settingsFetchState: fetchState,
+        syncHealth: qboView.syncHealth,
+        syncStatusOptions: qboSyncStatusOptions,
+    };
+};
 /**
  * Bundled view for the branding settings form: the draft `localData` (seeded
  * from the existing settings until the user edits), the business-address label