@zeniai/client-epic-state 5.2.10-betaAK1 → 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.js

@@ -317,6 +317,7 @@ const connectInvoicingStripeEpic_1 = require("./view/invoicing/settingsView/epic
 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 subscriptionActionEpic_1 = require("./view/invoicing/subscriptionAction/subscriptionActionEpic");
 const fetchMonthClosePerformanceTrendEpic_1 = require("./view/monthEndCloseChecksView/epics/fetchMonthClosePerformanceTrendEpic");
@@ -1363,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

@@ -314,6 +314,7 @@ import { connectInvoicingStripeEpic } from './view/invoicing/settingsView/epics/
 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 { runInvoicingSubscriptionActionEpic, } from './view/invoicing/subscriptionAction/subscriptionActionEpic';
 import { fetchMonthClosePerformanceTrendEpic, } from './view/monthEndCloseChecksView/epics/fetchMonthClosePerformanceTrendEpic';
@@ -1360,6 +1361,7 @@ const ALL_EPICS = [
     submitFeedbackEpic,
     submitIntlVerificationEpic,
     submitInvoicingBrandingFormEpic,
+    submitInvoicingQboSettingsEpic,
     submitQuestionEpic,
     syncInvoicingSubscriptionCouponsEpic,
     syncTabsAfterAutomatchEpic,

package/lib/esm/index.js

@@ -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, resetInvoicingQboSettingsDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingQboSettingsDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
+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/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,9 +42,9 @@ const settingsView = createSlice({
         saveInvoicingSettingsSuccess(draft, action) {
             draft.settings = action.payload;
             draft.saveFetchState = { fetchState: 'Completed', error: undefined };
-            // The server is authoritative again, so the draft steps aside rather than
-            // shadowing what was just persisted.
-            draft.qboDraft = 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 };
@@ -60,6 +66,11 @@ const settingsView = createSlice({
         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;
         },
@@ -94,5 +105,5 @@ const settingsView = createSlice({
         });
     },
 });
-export const { fetchInvoicingSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, saveInvoicingSettings, saveInvoicingSettingsSuccess, saveInvoicingSettingsFailure, resetSaveInvoicingSettings, updateInvoicingBrandingFormDraft, submitInvoicingBrandingForm, resetInvoicingBrandingFormDraft, updateInvoicingQboSettingsDraft, resetInvoicingQboSettingsDraft, 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,8 +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
@@ -51,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,
@@ -119,7 +125,9 @@ export const getInvoicingQboSettingsFormView = (state) => {
             fetchState === 'In-Progress' ||
             isInvoicingAccountingPickerDataLoading(state),
         isSyncEnabledSaved: settings?.qbo?.enabled === true,
-        localData: qboDraft ?? settings?.qbo ?? {},
+        // 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

package/lib/index.d.ts

@@ -1235,10 +1235,14 @@ export { getInvoicingCatalogItemDetail } from './view/invoicing/invoicingCatalog
 export { getInvoicingPlanById } from './entity/invoicing/plan/planSelector';
 export { getInvoicingProductById } from './entity/invoicing/product/productSelector';
 export type { InvoicingCatalogItemDetailView } from './view/invoicing/invoicingCatalogItemDetailView/invoicingCatalogItemDetailViewSelector';
-export { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, resetInvoicingBrandingFormDraft, resetInvoicingQboSettingsDraft, resetSaveInvoicingSettings, saveInvoicingSettings, submitInvoicingBrandingForm, updateInvoicingBrandingFormDraft, updateInvoicingQboSettingsDraft, updateInvoicingSettings, } from './view/invoicing/settingsView/settingsViewReducer';
+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 type { InvoicingBrandingFormView, InvoicingQboSettingsFormView, InvoicingSettingsHubView, InvoicingSettingsView, } from './view/invoicing/settingsView/settingsViewSelector';
 export type { InvoicingBrandingFormLocalData } from './view/invoicing/settingsView/invoicingBrandingFormConfig';
+export type { InvoicingQboSettingsLocalData } from './view/invoicing/settingsView/invoicingQboSettingsFormConfig';
+export { INVOICING_QBO_ACCOUNT_MAPPING_CODES, toInvoicingQboAccountMappingCode, } from './entity/invoicing/invoicingCommonPayload';
+export type { InvoicingQboAccountMappingCode } 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';
 export { fetchInvoicingAccountingPickers, fetchInvoicingQboConnection, fetchInvoicingQboSyncHealth, retryInvoicingQboSyncTask, startInvoicingQboBackfill, } from './view/invoicing/invoicingQboView/invoicingQboViewReducer';

package/lib/index.js

@@ -83,7 +83,7 @@ exports.runInvoicingCatalogPlanAction = exports.getInvoicingInvoiceActionState =
 exports.getInvoicingSetupIntentFetchState = exports.getInvoicingSetupIntent = exports.getInvoicingSentPaymentLinkMagicUrl = exports.getInvoicingSentPaymentLinkEmail = exports.getInvoicingPlaidLinkTokenFetchState = exports.getInvoicingPlaidLinkToken = exports.getInvoicingPaymentMethodSaveState = exports.getInvoicingPaymentLinkSendState = exports.sendInvoicingPaymentLink = exports.saveInvoicingPaymentMethod = exports.resetInvoicingCustomerPaymentMethod = exports.fetchInvoicingPlaidLinkToken = exports.createInvoicingSetupIntent = exports.getInvoicingCustomerDetail = exports.fetchInvoicingCustomerDetailPage = exports.fetchInvoicingCustomerDetail = exports.getInvoicingCustomerListView = exports.INVOICING_CUSTOMER_COLUMNS = exports.ALL_INVOICING_CUSTOMER_TAB_IDS = exports.ALL_INVOICING_CUSTOMER_SORT_KEYS = exports.updateInvoicingCustomerFilters = exports.setInvoicingCustomerActiveTab = exports.fetchInvoicingCustomerListPage = exports.fetchInvoicingCustomerList = exports.fetchInvoicingCustomerCounts = exports.updateInvoicingCustomers = exports.removeInvoicingCustomer = exports.INVOICING_LIST_PAGE_SIZE = exports.getInvoicingDataImportActionState = exports.uploadInvoicingMigrationFiles = exports.startInvoicingMigration = exports.rollbackInvoicingMigration = exports.retryInvoicingMigration = exports.connectInvoicingChargebee = exports.getInvoicingDataImportView = exports.setInvoicingActiveMigrationSessionId = exports.fetchInvoicingMigrationSessions = exports.fetchInvoicingMigrationSession = exports.fetchInvoicingMigrationDiagnostics = exports.fetchInvoicingDataImportStatus = exports.getInvoicingPaymentActionState = exports.runInvoicingPaymentAction = exports.getInvoicingDunningActionState = exports.runInvoicingDunningAction = exports.getInvoicingSubscriptionActionState = exports.runInvoicingSubscriptionAction = exports.getInvoicingDiscountActionState = exports.runInvoicingDiscountAction = exports.getInvoicingCatalogActionState = exports.runInvoicingCatalogProductAction = void 0;
 exports.updateInvoicingCouponFilters = exports.setInvoicingCouponActiveTab = exports.fetchInvoicingCouponListPage = exports.fetchInvoicingCouponList = exports.fetchInvoicingCouponCounts = exports.updateInvoicingCoupons = exports.removeInvoicingCoupon = exports.getInvoicingCreditNoteDetail = exports.getInvoicingCreditNoteById = exports.fetchInvoicingCreditNoteDetail = exports.getInvoicingCreditNoteListView = exports.INVOICING_CREDIT_NOTE_COLUMNS = exports.ALL_INVOICING_CREDIT_NOTE_TAB_IDS = exports.ALL_INVOICING_CREDIT_NOTE_SORT_KEYS = exports.updateInvoicingCreditNoteFilters = exports.setInvoicingCreditNoteActiveTab = exports.fetchInvoicingCreditNoteListPage = exports.fetchInvoicingCreditNoteList = exports.fetchInvoicingCreditNoteCounts = exports.updateInvoicingCreditNotes = exports.removeInvoicingCreditNote = exports.getInvoicingTransactionDetail = exports.getInvoicingTransactionById = exports.fetchInvoicingTransactionDetail = exports.getInvoicingTransactionListView = exports.INVOICING_TRANSACTION_COLUMNS = exports.ALL_INVOICING_TRANSACTION_TAB_IDS = exports.ALL_INVOICING_TRANSACTION_SORT_KEYS = exports.updateInvoicingTransactionFilters = exports.setInvoicingTransactionActiveTab = exports.fetchInvoicingTransactionListPage = exports.fetchInvoicingTransactionList = exports.updateInvoicingTransactions = exports.removeInvoicingTransaction = exports.getInvoicingSubscriptionDetail = exports.getInvoicingSubscriptionById = exports.fetchInvoicingSubscriptionDetail = exports.getInvoicingSubscriptionListView = exports.INVOICING_SUBSCRIPTION_COLUMNS = exports.ALL_INVOICING_SUBSCRIPTION_TAB_IDS = exports.ALL_INVOICING_SUBSCRIPTION_SORT_KEYS = exports.updateInvoicingSubscriptionFilters = exports.setInvoicingSubscriptionActiveTab = exports.fetchInvoicingSubscriptionListPage = exports.fetchInvoicingSubscriptionList = exports.fetchInvoicingSubscriptionCounts = exports.updateInvoicingSubscriptions = exports.removeInvoicingSubscription = exports.resetPromotionalCreditAction = exports.submitAddPromotionalCredits = void 0;
 exports.connectInvoicingStripe = exports.getInvoicingProductById = exports.getInvoicingPlanById = exports.getInvoicingCatalogItemDetail = exports.fetchInvoicingCatalogItemDetail = exports.getInvoicingCatalogListView = exports.INVOICING_PRODUCT_COLUMNS = exports.ALL_INVOICING_PRODUCT_SORT_KEYS = exports.updateInvoicingCatalogProductFilters = exports.updateInvoicingCatalogPlanFilters = exports.fetchInvoicingCatalogProductList = exports.fetchInvoicingCatalogPlanList = exports.fetchInvoicingCatalogListPage = exports.fetchInvoicingCatalogCounts = exports.updateInvoicingProducts = exports.removeInvoicingProduct = exports.updateInvoicingPlans = exports.removeInvoicingPlan = exports.mergeInvoicingPlanSubFamily = exports.getInvoicingDunningEmailPreview = exports.getInvoicingDunningCaseDetail = exports.getInvoicingDunningCaseById = exports.invalidateInvoicingDunningEmailPreview = exports.fetchInvoicingDunningEmailPreviewPage = exports.fetchInvoicingDunningCaseDetail = exports.clearInvoicingDunningCaseDetailView = exports.getInvoicingDunningCaseListView = exports.INVOICING_DUNNING_CASE_COLUMNS = exports.ALL_INVOICING_DUNNING_CASE_TAB_IDS = exports.ALL_INVOICING_DUNNING_CASE_SORT_KEYS = exports.updateInvoicingDunningCaseFilters = exports.setInvoicingDunningCaseActiveTab = exports.fetchInvoicingDunningCaseListPage = exports.fetchInvoicingDunningCaseList = exports.fetchInvoicingDunningCaseCounts = exports.updateInvoicingDunningCases = exports.removeInvoicingDunningCase = exports.getInvoicingCouponDetail = exports.fetchInvoicingCouponDetail = exports.getInvoicingCouponById = exports.getInvoicingCouponListView = exports.getInvoicingCouponListNextCursor = exports.getInvoicingCouponListItems = exports.getInvoicingCouponListHasMore = exports.getInvoicingCouponListFilters = exports.getInvoicingCouponListFetchState = exports.getInvoicingCouponCounts = exports.INVOICING_COUPON_COLUMNS = exports.ALL_INVOICING_COUPON_TAB_IDS = exports.ALL_INVOICING_COUPON_SORT_KEYS = void 0;
-exports.getInvoicingOnboardingGateView = exports.getInvoicingConfigView = exports.updateInvoicingConfig = exports.resetInvoicingConfigActionStates = exports.fetchInvoicingConfig = exports.enableInvoicing = exports.acceptInvoicingTerms = exports.withInvoicingQboAccountMappingId = exports.toInvoicingQboCustomerMatchingMode = exports.toInvoicingNamedOptionsByKey = exports.getInvoicingQboAccountMappingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.getInvoicingQboView = exports.invoicingAccountsForQboAccountTypes = exports.INVOICING_INCOME_ACCOUNT_TYPES = exports.startInvoicingQboBackfill = exports.retryInvoicingQboSyncTask = exports.fetchInvoicingQboSyncHealth = exports.fetchInvoicingQboConnection = exports.fetchInvoicingAccountingPickers = exports.isStripeConnectedFromSettings = exports.initialInvoicingBrandingFormLocalData = exports.entityToInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = exports.getInvoicingSettingsView = exports.getInvoicingSettingsHubView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = exports.getInvoicingQboSettingsFormView = exports.getInvoicingBrandingFormView = exports.updateInvoicingSettings = exports.updateInvoicingQboSettingsDraft = exports.updateInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.saveInvoicingSettings = exports.resetSaveInvoicingSettings = exports.resetInvoicingQboSettingsDraft = exports.resetInvoicingBrandingFormDraft = exports.fetchInvoicingSettings = exports.disconnectInvoicingStripe = void 0;
+exports.getInvoicingOnboardingGateView = exports.getInvoicingConfigView = exports.updateInvoicingConfig = exports.resetInvoicingConfigActionStates = exports.fetchInvoicingConfig = exports.enableInvoicing = exports.acceptInvoicingTerms = exports.withInvoicingQboAccountMappingId = exports.toInvoicingQboCustomerMatchingMode = exports.toInvoicingNamedOptionsByKey = exports.getInvoicingQboAccountMappingId = exports.INVOICING_QBO_CUSTOMER_MATCHING_MODES = exports.getInvoicingQboView = exports.invoicingAccountsForQboAccountTypes = exports.INVOICING_INCOME_ACCOUNT_TYPES = exports.startInvoicingQboBackfill = exports.retryInvoicingQboSyncTask = exports.fetchInvoicingQboSyncHealth = exports.fetchInvoicingQboConnection = exports.fetchInvoicingAccountingPickers = exports.isStripeConnectedFromSettings = exports.initialInvoicingBrandingFormLocalData = exports.entityToInvoicingBrandingFormLocalData = exports.INVOICING_BUSINESS_ADDRESS_TYPE = exports.invoicingQboSettingsLocalDataToPayload = exports.initialInvoicingQboSettingsLocalData = exports.entityToInvoicingQboSettingsLocalData = exports.toInvoicingQboAccountMappingCode = exports.INVOICING_QBO_ACCOUNT_MAPPING_CODES = exports.getInvoicingSettingsView = exports.getInvoicingSettingsHubView = exports.getInvoicingSettingsFetchState = exports.getInvoicingSettings = exports.getInvoicingQboSettingsFormView = exports.getInvoicingBrandingFormView = exports.updateInvoicingSettings = exports.updateInvoicingQboSettingsDraft = exports.updateInvoicingBrandingFormDraft = exports.submitInvoicingQboSettings = exports.submitInvoicingBrandingForm = exports.saveInvoicingSettings = exports.resetSaveInvoicingSettings = exports.resetInvoicingQboSettingsDraft = exports.resetInvoicingBrandingFormDraft = exports.fetchInvoicingSettings = exports.disconnectInvoicingStripe = void 0;
 const allowedValue_1 = require("./commonStateTypes/allowedValue");
 Object.defineProperty(exports, "isAllowedValueWithCode", { enumerable: true, get: function () { return allowedValue_1.isAllowedValueWithCode; } });
 Object.defineProperty(exports, "isAllowedValueWithID", { enumerable: true, get: function () { return allowedValue_1.isAllowedValueWithID; } });
@@ -3095,6 +3095,7 @@ Object.defineProperty(exports, "resetInvoicingQboSettingsDraft", { enumerable: t
 Object.defineProperty(exports, "resetSaveInvoicingSettings", { enumerable: true, get: function () { return settingsViewReducer_2.resetSaveInvoicingSettings; } });
 Object.defineProperty(exports, "saveInvoicingSettings", { enumerable: true, get: function () { return settingsViewReducer_2.saveInvoicingSettings; } });
 Object.defineProperty(exports, "submitInvoicingBrandingForm", { enumerable: true, get: function () { return settingsViewReducer_2.submitInvoicingBrandingForm; } });
+Object.defineProperty(exports, "submitInvoicingQboSettings", { enumerable: true, get: function () { return settingsViewReducer_2.submitInvoicingQboSettings; } });
 Object.defineProperty(exports, "updateInvoicingBrandingFormDraft", { enumerable: true, get: function () { return settingsViewReducer_2.updateInvoicingBrandingFormDraft; } });
 Object.defineProperty(exports, "updateInvoicingQboSettingsDraft", { enumerable: true, get: function () { return settingsViewReducer_2.updateInvoicingQboSettingsDraft; } });
 Object.defineProperty(exports, "updateInvoicingSettings", { enumerable: true, get: function () { return settingsViewReducer_2.updateInvoicingSettings; } });
@@ -3105,6 +3106,13 @@ Object.defineProperty(exports, "getInvoicingSettings", { enumerable: true, get:
 Object.defineProperty(exports, "getInvoicingSettingsFetchState", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsFetchState; } });
 Object.defineProperty(exports, "getInvoicingSettingsHubView", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsHubView; } });
 Object.defineProperty(exports, "getInvoicingSettingsView", { enumerable: true, get: function () { return settingsViewSelector_2.getInvoicingSettingsView; } });
+var invoicingCommonPayload_2 = require("./entity/invoicing/invoicingCommonPayload");
+Object.defineProperty(exports, "INVOICING_QBO_ACCOUNT_MAPPING_CODES", { enumerable: true, get: function () { return invoicingCommonPayload_2.INVOICING_QBO_ACCOUNT_MAPPING_CODES; } });
+Object.defineProperty(exports, "toInvoicingQboAccountMappingCode", { enumerable: true, get: function () { return invoicingCommonPayload_2.toInvoicingQboAccountMappingCode; } });
+var invoicingQboSettingsFormConfig_1 = require("./view/invoicing/settingsView/invoicingQboSettingsFormConfig");
+Object.defineProperty(exports, "entityToInvoicingQboSettingsLocalData", { enumerable: true, get: function () { return invoicingQboSettingsFormConfig_1.entityToInvoicingQboSettingsLocalData; } });
+Object.defineProperty(exports, "initialInvoicingQboSettingsLocalData", { enumerable: true, get: function () { return invoicingQboSettingsFormConfig_1.initialInvoicingQboSettingsLocalData; } });
+Object.defineProperty(exports, "invoicingQboSettingsLocalDataToPayload", { enumerable: true, get: function () { return invoicingQboSettingsFormConfig_1.invoicingQboSettingsLocalDataToPayload; } });
 var invoicingBrandingFormConfig_1 = require("./view/invoicing/settingsView/invoicingBrandingFormConfig");
 Object.defineProperty(exports, "INVOICING_BUSINESS_ADDRESS_TYPE", { enumerable: true, get: function () { return invoicingBrandingFormConfig_1.INVOICING_BUSINESS_ADDRESS_TYPE; } });
 Object.defineProperty(exports, "entityToInvoicingBrandingFormLocalData", { enumerable: true, get: function () { return invoicingBrandingFormConfig_1.entityToInvoicingBrandingFormLocalData; } });
@@ -3123,12 +3131,12 @@ Object.defineProperty(exports, "INVOICING_INCOME_ACCOUNT_TYPES", { enumerable: t
 Object.defineProperty(exports, "invoicingAccountsForQboAccountTypes", { enumerable: true, get: function () { return invoicingQboViewSelector_1.invoicingAccountsForQboAccountTypes; } });
 var invoicingQboViewSelector_2 = require("./view/invoicing/invoicingQboView/invoicingQboViewSelector");
 Object.defineProperty(exports, "getInvoicingQboView", { enumerable: true, get: function () { return invoicingQboViewSelector_2.getInvoicingQboView; } });
-var invoicingCommonPayload_2 = require("./entity/invoicing/invoicingCommonPayload");
-Object.defineProperty(exports, "INVOICING_QBO_CUSTOMER_MATCHING_MODES", { enumerable: true, get: function () { return invoicingCommonPayload_2.INVOICING_QBO_CUSTOMER_MATCHING_MODES; } });
-Object.defineProperty(exports, "getInvoicingQboAccountMappingId", { enumerable: true, get: function () { return invoicingCommonPayload_2.getInvoicingQboAccountMappingId; } });
-Object.defineProperty(exports, "toInvoicingNamedOptionsByKey", { enumerable: true, get: function () { return invoicingCommonPayload_2.toInvoicingNamedOptionsByKey; } });
-Object.defineProperty(exports, "toInvoicingQboCustomerMatchingMode", { enumerable: true, get: function () { return invoicingCommonPayload_2.toInvoicingQboCustomerMatchingMode; } });
-Object.defineProperty(exports, "withInvoicingQboAccountMappingId", { enumerable: true, get: function () { return invoicingCommonPayload_2.withInvoicingQboAccountMappingId; } });
+var invoicingCommonPayload_3 = require("./entity/invoicing/invoicingCommonPayload");
+Object.defineProperty(exports, "INVOICING_QBO_CUSTOMER_MATCHING_MODES", { enumerable: true, get: function () { return invoicingCommonPayload_3.INVOICING_QBO_CUSTOMER_MATCHING_MODES; } });
+Object.defineProperty(exports, "getInvoicingQboAccountMappingId", { enumerable: true, get: function () { return invoicingCommonPayload_3.getInvoicingQboAccountMappingId; } });
+Object.defineProperty(exports, "toInvoicingNamedOptionsByKey", { enumerable: true, get: function () { return invoicingCommonPayload_3.toInvoicingNamedOptionsByKey; } });
+Object.defineProperty(exports, "toInvoicingQboCustomerMatchingMode", { enumerable: true, get: function () { return invoicingCommonPayload_3.toInvoicingQboCustomerMatchingMode; } });
+Object.defineProperty(exports, "withInvoicingQboAccountMappingId", { enumerable: true, get: function () { return invoicingCommonPayload_3.withInvoicingQboAccountMappingId; } });
 // ── Invoicing: config ─────────────────────────────────────────────────────────
 var invoicingConfigViewReducer_1 = require("./view/invoicing/invoicingConfigView/invoicingConfigViewReducer");
 Object.defineProperty(exports, "acceptInvoicingTerms", { enumerable: true, get: function () { return invoicingConfigViewReducer_1.acceptInvoicingTerms; } });

package/lib/view/invoicing/settingsView/epics/settingsViewActionType.d.ts

@@ -1,5 +1,5 @@
 import { updateAddresses } from '../../../../entity/address/addressReducer';
 import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
-import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection } from '../settingsViewReducer';
+import { connectInvoicingStripe, disconnectInvoicingStripe, fetchInvoicingSettings, invoicingStripeConnectionFailure, saveInvoicingSettings, saveInvoicingSettingsFailure, saveInvoicingSettingsSuccess, submitInvoicingQboSettings, updateInvoicingSettings, updateInvoicingSettingsFailure, updateInvoicingStripeConnection } from '../settingsViewReducer';
 /** Every action the settings epics accept or emit. */
-export type InvoicingSettingsViewActionType = ReturnType<typeof fetchInvoicingSettings> | ReturnType<typeof updateInvoicingSettings> | ReturnType<typeof updateInvoicingSettingsFailure> | ReturnType<typeof saveInvoicingSettings> | ReturnType<typeof saveInvoicingSettingsSuccess> | ReturnType<typeof saveInvoicingSettingsFailure> | ReturnType<typeof connectInvoicingStripe> | ReturnType<typeof disconnectInvoicingStripe> | ReturnType<typeof updateInvoicingStripeConnection> | ReturnType<typeof invoicingStripeConnectionFailure> | ReturnType<typeof updateAddresses> | ReturnType<typeof openSnackbar>;
+export type InvoicingSettingsViewActionType = ReturnType<typeof fetchInvoicingSettings> | ReturnType<typeof updateInvoicingSettings> | ReturnType<typeof updateInvoicingSettingsFailure> | ReturnType<typeof saveInvoicingSettings> | ReturnType<typeof saveInvoicingSettingsSuccess> | ReturnType<typeof submitInvoicingQboSettings> | ReturnType<typeof saveInvoicingSettingsFailure> | ReturnType<typeof connectInvoicingStripe> | ReturnType<typeof disconnectInvoicingStripe> | ReturnType<typeof updateInvoicingStripeConnection> | ReturnType<typeof invoicingStripeConnectionFailure> | ReturnType<typeof updateAddresses> | ReturnType<typeof openSnackbar>;

package/lib/view/invoicing/settingsView/epics/submitInvoicingQboSettingsEpic.d.ts

@@ -0,0 +1,11 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { Observable } from 'rxjs';
+import { RootState } from '../../../../rootStateTypes';
+import { InvoicingSettingsViewActionType } from './settingsViewActionType';
+/**
+ * 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 declare const submitInvoicingQboSettingsEpic: (actions$: ActionsObservable<InvoicingSettingsViewActionType>, state$: StateObservable<RootState>) => Observable<InvoicingSettingsViewActionType>;

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

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitInvoicingQboSettingsEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const invoicingQboSettingsFormConfig_1 = require("../invoicingQboSettingsFormConfig");
+const settingsViewReducer_1 = require("../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.
+ */
+const submitInvoicingQboSettingsEpic = (actions$, state$) => actions$.pipe((0, operators_1.filter)(settingsViewReducer_1.submitInvoicingQboSettings.match), (0, operators_1.withLatestFrom)(state$), (0, operators_1.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 rxjs_1.EMPTY;
+    }
+    return (0, rxjs_1.of)((0, settingsViewReducer_1.saveInvoicingSettings)({
+        settings: { qbo: (0, invoicingQboSettingsFormConfig_1.invoicingQboSettingsLocalDataToPayload)(qboDraft) },
+        snackbarSection: 'invoicing_qbo_settings_save',
+    }));
+}));
+exports.submitInvoicingQboSettingsEpic = submitInvoicingQboSettingsEpic;

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

@@ -0,0 +1,28 @@
+import { InvoicingQboAccountMappingCode, InvoicingQboSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+/**
+ * The QBO configuration page's local data. A client shape, not the wire one: the
+ * page edits a flat `accountIdByMappingCode` map keyed by the config's mapping
+ * codes, where the payload carries one field pair per slot and two shapes for
+ * each. {@link entityToInvoicingQboSettingsLocalData} and
+ * {@link invoicingQboSettingsLocalDataToPayload} convert at the boundary.
+ */
+export interface InvoicingQboSettingsLocalData {
+    /** Mapping slot to the QuickBooks account id the picker selected. */
+    accountIdByMappingCode: Partial<Record<InvoicingQboAccountMappingCode, string>>;
+    autoCreateItems: boolean;
+    closedPeriodVoidAsCreditMemo: boolean;
+    customerMatching: string;
+    isSyncEnabled: boolean;
+    /** ISO date, empty when unset — the picker clears to empty, not to null. */
+    syncStartDate: string;
+    trackingCategoriesEnabled: boolean;
+}
+export declare const initialInvoicingQboSettingsLocalData: InvoicingQboSettingsLocalData;
+/** The settings response as the page edits it. */
+export declare const entityToInvoicingQboSettingsLocalData: (qbo: InvoicingQboSettingsPayload | null | undefined) => InvoicingQboSettingsLocalData;
+/**
+ * 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 declare const invoicingQboSettingsLocalDataToPayload: (localData: InvoicingQboSettingsLocalData) => InvoicingQboSettingsPayload;

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

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invoicingQboSettingsLocalDataToPayload = exports.entityToInvoicingQboSettingsLocalData = exports.initialInvoicingQboSettingsLocalData = void 0;
+const invoicingCommonPayload_1 = require("../../../entity/invoicing/invoicingCommonPayload");
+exports.initialInvoicingQboSettingsLocalData = {
+    accountIdByMappingCode: {},
+    autoCreateItems: false,
+    closedPeriodVoidAsCreditMemo: false,
+    customerMatching: '',
+    isSyncEnabled: false,
+    syncStartDate: '',
+    trackingCategoriesEnabled: false,
+};
+/** The settings response as the page edits it. */
+const entityToInvoicingQboSettingsLocalData = (qbo) => {
+    const accountIdByMappingCode = {};
+    invoicingCommonPayload_1.INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const accountId = (0, invoicingCommonPayload_1.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,
+    };
+};
+exports.entityToInvoicingQboSettingsLocalData = entityToInvoicingQboSettingsLocalData;
+/**
+ * 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.
+ */
+const invoicingQboSettingsLocalDataToPayload = (localData) => {
+    let accountMappings = {};
+    invoicingCommonPayload_1.INVOICING_QBO_ACCOUNT_MAPPING_CODES.forEach((code) => {
+        const accountId = localData.accountIdByMappingCode[code] ?? '';
+        if (accountId !== '') {
+            accountMappings = (0, invoicingCommonPayload_1.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,
+    };
+};
+exports.invoicingQboSettingsLocalDataToPayload = invoicingQboSettingsLocalDataToPayload;

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

@@ -1,7 +1,8 @@
-import { InvoicingQboSettingsPayload, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { SnackbarMessageSections } from '../../../entity/snackbar/snackbarTypes';
 import { ZeniAPIStatus } from '../../../responsePayload';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+import { InvoicingQboSettingsLocalData } from './invoicingQboSettingsFormConfig';
 import { StripeConnectCredentials } from './settingsViewPayload';
 import { InvoicingSettingsViewState } from './settingsViewState';
 export interface InvoicingStripeConnectionUpdate {
@@ -20,7 +21,7 @@ export declare const initialState: InvoicingSettingsViewState;
 export declare const fetchInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/fetchInvoicingSettings">, updateInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingSettingsPayload, "invoicingSettingsView/updateInvoicingSettings">, updateInvoicingSettingsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/updateInvoicingSettingsFailure">, saveInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithPayload<SaveInvoicingSettingsPayload, "invoicingSettingsView/saveInvoicingSettings">, saveInvoicingSettingsSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingSettingsPayload, "invoicingSettingsView/saveInvoicingSettingsSuccess">, saveInvoicingSettingsFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/saveInvoicingSettingsFailure">, resetSaveInvoicingSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetSaveInvoicingSettings">, updateInvoicingBrandingFormDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     localData: InvoicingBrandingFormLocalData;
 }, "invoicingSettingsView/updateInvoicingBrandingFormDraft">, submitInvoicingBrandingForm: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/submitInvoicingBrandingForm">, resetInvoicingBrandingFormDraft: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetInvoicingBrandingFormDraft">, updateInvoicingQboSettingsDraft: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
-    localData: InvoicingQboSettingsPayload;
-}, "invoicingSettingsView/updateInvoicingQboSettingsDraft">, resetInvoicingQboSettingsDraft: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetInvoicingQboSettingsDraft">, connectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[credentials: StripeConnectCredentials], StripeConnectCredentials, "invoicingSettingsView/connectInvoicingStripe", never, never>, disconnectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/disconnectInvoicingStripe">, updateInvoicingStripeConnection: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingStripeConnectionUpdate, "invoicingSettingsView/updateInvoicingStripeConnection">, invoicingStripeConnectionFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/invoicingStripeConnectionFailure">;
+    localData: InvoicingQboSettingsLocalData;
+}, "invoicingSettingsView/updateInvoicingQboSettingsDraft">, submitInvoicingQboSettings: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/submitInvoicingQboSettings">, resetInvoicingQboSettingsDraft: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/resetInvoicingQboSettingsDraft">, connectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[credentials: StripeConnectCredentials], StripeConnectCredentials, "invoicingSettingsView/connectInvoicingStripe", never, never>, disconnectInvoicingStripe: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"invoicingSettingsView/disconnectInvoicingStripe">, updateInvoicingStripeConnection: import("@reduxjs/toolkit").ActionCreatorWithPayload<InvoicingStripeConnectionUpdate, "invoicingSettingsView/updateInvoicingStripeConnection">, invoicingStripeConnectionFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<ZeniAPIStatus<Record<string, unknown>>, "invoicingSettingsView/invoicingStripeConnectionFailure">;
 declare const _default: import("redux").Reducer<InvoicingSettingsViewState>;
 export default _default;

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

@@ -1,9 +1,10 @@
 "use strict";
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.invoicingStripeConnectionFailure = exports.updateInvoicingStripeConnection = exports.disconnectInvoicingStripe = exports.connectInvoicingStripe = exports.resetInvoicingQboSettingsDraft = exports.updateInvoicingQboSettingsDraft = exports.resetInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.updateInvoicingBrandingFormDraft = exports.resetSaveInvoicingSettings = exports.saveInvoicingSettingsFailure = exports.saveInvoicingSettingsSuccess = exports.saveInvoicingSettings = exports.updateInvoicingSettingsFailure = exports.updateInvoicingSettings = exports.fetchInvoicingSettings = exports.initialState = void 0;
+exports.invoicingStripeConnectionFailure = exports.updateInvoicingStripeConnection = exports.disconnectInvoicingStripe = exports.connectInvoicingStripe = exports.resetInvoicingQboSettingsDraft = exports.submitInvoicingQboSettings = exports.updateInvoicingQboSettingsDraft = exports.resetInvoicingBrandingFormDraft = exports.submitInvoicingBrandingForm = exports.updateInvoicingBrandingFormDraft = exports.resetSaveInvoicingSettings = exports.saveInvoicingSettingsFailure = exports.saveInvoicingSettingsSuccess = exports.saveInvoicingSettings = exports.updateInvoicingSettingsFailure = exports.updateInvoicingSettings = exports.fetchInvoicingSettings = exports.initialState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const rootActions_1 = require("../../../rootActions");
+const invoicingQboSettingsFormConfig_1 = require("./invoicingQboSettingsFormConfig");
 exports.initialState = {
     fetchState: 'Not-Started',
     error: undefined,
@@ -26,6 +27,11 @@ const settingsView = (0, toolkit_1.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 = (0, invoicingQboSettingsFormConfig_1.entityToInvoicingQboSettingsLocalData)(action.payload.qbo);
+            }
         },
         updateInvoicingSettingsFailure(draft, action) {
             draft.fetchState = 'Error';
@@ -40,9 +46,9 @@ const settingsView = (0, toolkit_1.createSlice)({
         saveInvoicingSettingsSuccess(draft, action) {
             draft.settings = action.payload;
             draft.saveFetchState = { fetchState: 'Completed', error: undefined };
-            // The server is authoritative again, so the draft steps aside rather than
-            // shadowing what was just persisted.
-            draft.qboDraft = 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 = (0, invoicingQboSettingsFormConfig_1.entityToInvoicingQboSettingsLocalData)(action.payload.qbo);
         },
         saveInvoicingSettingsFailure(draft, action) {
             draft.saveFetchState = { fetchState: 'Error', error: action.payload };
@@ -64,6 +70,11 @@ const settingsView = (0, toolkit_1.createSlice)({
         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;
         },
@@ -98,5 +109,5 @@ const settingsView = (0, toolkit_1.createSlice)({
         });
     },
 });
-_a = settingsView.actions, exports.fetchInvoicingSettings = _a.fetchInvoicingSettings, exports.updateInvoicingSettings = _a.updateInvoicingSettings, exports.updateInvoicingSettingsFailure = _a.updateInvoicingSettingsFailure, exports.saveInvoicingSettings = _a.saveInvoicingSettings, exports.saveInvoicingSettingsSuccess = _a.saveInvoicingSettingsSuccess, exports.saveInvoicingSettingsFailure = _a.saveInvoicingSettingsFailure, exports.resetSaveInvoicingSettings = _a.resetSaveInvoicingSettings, exports.updateInvoicingBrandingFormDraft = _a.updateInvoicingBrandingFormDraft, exports.submitInvoicingBrandingForm = _a.submitInvoicingBrandingForm, exports.resetInvoicingBrandingFormDraft = _a.resetInvoicingBrandingFormDraft, exports.updateInvoicingQboSettingsDraft = _a.updateInvoicingQboSettingsDraft, exports.resetInvoicingQboSettingsDraft = _a.resetInvoicingQboSettingsDraft, exports.connectInvoicingStripe = _a.connectInvoicingStripe, exports.disconnectInvoicingStripe = _a.disconnectInvoicingStripe, exports.updateInvoicingStripeConnection = _a.updateInvoicingStripeConnection, exports.invoicingStripeConnectionFailure = _a.invoicingStripeConnectionFailure;
+_a = settingsView.actions, exports.fetchInvoicingSettings = _a.fetchInvoicingSettings, exports.updateInvoicingSettings = _a.updateInvoicingSettings, exports.updateInvoicingSettingsFailure = _a.updateInvoicingSettingsFailure, exports.saveInvoicingSettings = _a.saveInvoicingSettings, exports.saveInvoicingSettingsSuccess = _a.saveInvoicingSettingsSuccess, exports.saveInvoicingSettingsFailure = _a.saveInvoicingSettingsFailure, exports.resetSaveInvoicingSettings = _a.resetSaveInvoicingSettings, exports.updateInvoicingBrandingFormDraft = _a.updateInvoicingBrandingFormDraft, exports.submitInvoicingBrandingForm = _a.submitInvoicingBrandingForm, exports.resetInvoicingBrandingFormDraft = _a.resetInvoicingBrandingFormDraft, exports.updateInvoicingQboSettingsDraft = _a.updateInvoicingQboSettingsDraft, exports.submitInvoicingQboSettings = _a.submitInvoicingQboSettings, exports.resetInvoicingQboSettingsDraft = _a.resetInvoicingQboSettingsDraft, exports.connectInvoicingStripe = _a.connectInvoicingStripe, exports.disconnectInvoicingStripe = _a.disconnectInvoicingStripe, exports.updateInvoicingStripeConnection = _a.updateInvoicingStripeConnection, exports.invoicingStripeConnectionFailure = _a.invoicingStripeConnectionFailure;
 exports.default = settingsView.reducer;

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

@@ -1,11 +1,12 @@
 import { NestedAccountHierarchyForReport } from '../../../commonStateTypes/accountView/nestedAccountID';
 import { FetchState, FetchStateAndError } from '../../../commonStateTypes/common';
-import { InvoicingDunningActionOption, InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingQboSettingsPayload, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingDunningActionOption, InvoicingNamedOption, InvoicingQboAccountMappingKindOption, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { ZeniAPIStatus } from '../../../responsePayload';
 import { RootState } from '../../../rootStateTypes';
 import { InvoicingQboConnection, InvoicingQboSyncHealth } from '../invoicingQboView/invoicingQboViewPayload';
 import { InvoicingAccountingOption } from '../invoicingQboView/invoicingQboViewSelector';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+import { InvoicingQboSettingsLocalData } from './invoicingQboSettingsFormConfig';
 /**
  * Shared primitive: the raw invoicing settings. Consumed internally by other
  * CES selectors (create-invoice, customer-detail, overview) and by non-settings
@@ -98,7 +99,7 @@ export interface InvoicingQboSettingsFormView {
     /** The persisted sync toggle — the backfill guard checks that, not the draft. */
     isSyncEnabledSaved: boolean;
     /** The draft the page edits, seeded from the settings response. */
-    localData: InvoicingQboSettingsPayload;
+    localData: InvoicingQboSettingsLocalData;
     nestedAccountHierarchy: NestedAccountHierarchyForReport[];
     retryFetchStateByTaskId: Record<string, FetchStateAndError>;
     saveState: FetchStateAndError;

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

@@ -7,6 +7,7 @@ const addressViewSelector_1 = require("../../addressView/addressViewSelector");
 const invoicingConfigViewSelector_1 = require("../invoicingConfigView/invoicingConfigViewSelector");
 const invoicingQboViewSelector_1 = require("../invoicingQboView/invoicingQboViewSelector");
 const invoicingBrandingFormConfig_1 = require("./invoicingBrandingFormConfig");
+const invoicingQboSettingsFormConfig_1 = require("./invoicingQboSettingsFormConfig");
 /**
  * Shared primitive: the raw invoicing settings. Consumed internally by other
  * CES selectors (create-invoice, customer-detail, overview) and by non-settings
@@ -58,7 +59,12 @@ function deriveInvoicingEnablePrerequisites(settings, isQboConnected, qboAccount
     // 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);
+        qboAccountMappingKindOptions.every((option) => {
+            // A kind the client has no slot for cannot count as configured.
+            const code = (0, invoicingCommonPayload_1.toInvoicingQboAccountMappingCode)(option.code);
+            return (code != null &&
+                (0, invoicingCommonPayload_1.getInvoicingQboAccountMappingId)(accountMappings, code) != null);
+        });
     return {
         canEnable: isStripeConnected && isQboConfigured,
         isQboConfigured,
@@ -127,7 +133,9 @@ const getInvoicingQboSettingsFormView = (state) => {
             fetchState === 'In-Progress' ||
             (0, invoicingQboViewSelector_1.isInvoicingAccountingPickerDataLoading)(state),
         isSyncEnabledSaved: settings?.qbo?.enabled === true,
-        localData: qboDraft ?? settings?.qbo ?? {},
+        // 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 ?? invoicingQboSettingsFormConfig_1.initialInvoicingQboSettingsLocalData,
         nestedAccountHierarchy: qboView.nestedAccountHierarchy,
         retryFetchStateByTaskId: qboView.retryFetchStateByTaskId,
         saveState: saveFetchState.fetchState === 'Not-Started' && error != null

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

@@ -1,6 +1,7 @@
 import { FetchStateAndError, FetchedState } from '../../../commonStateTypes/common';
-import { InvoicingQboSettingsPayload, InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
+import { InvoicingSettingsPayload } from '../../../entity/invoicing/invoicingCommonPayload';
 import { InvoicingBrandingFormLocalData } from './invoicingBrandingFormConfig';
+import { InvoicingQboSettingsLocalData } from './invoicingQboSettingsFormConfig';
 export interface InvoicingSettingsViewState extends FetchedState {
     saveFetchState: FetchStateAndError;
     stripeFetchState: FetchStateAndError;
@@ -11,6 +12,6 @@ export interface InvoicingSettingsViewState extends FetchedState {
      * half-finished edit survives navigating away. Undefined until first edited,
      * which is what makes the server's settings the fallback.
      */
-    qboDraft?: InvoicingQboSettingsPayload;
+    qboDraft?: InvoicingQboSettingsLocalData;
     settings?: InvoicingSettingsPayload;
 }

package/package.json

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