@zeniai/client-epic-state 5.1.56 → 5.1.57-betaDI1

package/lib/view/expenseAutomationView/selectors/statementParseViewSelector.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyStatementParseFormChange = exports.toStatementUpdateLocalDataFromFormView = exports.getStatementParseFormView = exports.mergeStatementParseDeletedTransactionIds = exports.areStatementParseBalancesConsistent = exports.resolveStatementParseBalanceFields = exports.shouldRecalculateStatementParseBalances = exports.isStatementParseManualBalanceField = exports.isStatementParseTransactionFieldChange = exports.getDateFilteredDeletedTransactionIds = exports.getStatementTransactionPeriodById = exports.getParsedStatementDataForView = exports.filterStatementTransactionsByPeriod = exports.isStatementTransactionInPeriod = exports.getEffectiveStatementPeriod = void 0;
+exports.mergeStatementParseDeletedTransactionIds = exports.getDateFilteredDeletedTransactionIds = exports.getStatementTransactionPeriodById = exports.getParsedStatementDataForView = exports.filterStatementTransactionsByPeriod = exports.isStatementTransactionInPeriod = exports.getEffectiveStatementPeriod = void 0;
 const zeniDayJS_1 = require("../../../zeniDayJS");
 const getEffectiveStatementPeriod = (parsedMeta, localMeta) => ({
     statementStartDate: localMeta?.statementStartDate != null && localMeta.statementStartDate !== ''
@@ -73,122 +73,6 @@ const getDateFilteredDeletedTransactionIds = (allParsedTransactions, statementPe
         .map((transaction) => transaction.statementTransactionId);
 };
 exports.getDateFilteredDeletedTransactionIds = getDateFilteredDeletedTransactionIds;
-const roundCurrency = (value) => Math.round(value * 100) / 100;
-const toApiDateString = (value) => {
-    if (value == null || value === '') {
-        return '';
-    }
-    return (0, zeniDayJS_1.date)(value).format('YYYY-MM-DD');
-};
-const computeStatementTransactionTotals = (transactions) => {
-    const totalDeposits = roundCurrency(transactions
-        .filter((txn) => txn.transactionDirection === 'credit')
-        .reduce((sum, txn) => sum + Math.abs(txn.amount ?? 0), 0));
-    const totalPayments = roundCurrency(transactions
-        .filter((txn) => txn.transactionDirection === 'debit')
-        .reduce((sum, txn) => sum + Math.abs(txn.amount ?? 0), 0));
-    return { totalDeposits, totalPayments };
-};
-const computeStatementClosingBalance = (openingBalance, totalDeposits, totalPayments, accountType) => roundCurrency(accountType === 'credit_card'
-    ? openingBalance + totalPayments - totalDeposits
-    : openingBalance + totalDeposits - totalPayments);
-const filterFormTransactionsInPeriod = (transactions, statementStartDate, statementEndDate) => {
-    if (statementStartDate === '' || statementEndDate === '') {
-        return transactions;
-    }
-    const periodStart = (0, zeniDayJS_1.date)(statementStartDate).startOf('day');
-    const periodEnd = (0, zeniDayJS_1.date)(statementEndDate).startOf('day');
-    return transactions.filter((txn) => {
-        if (txn.transactionDate === '') {
-            return true;
-        }
-        const txnDate = (0, zeniDayJS_1.date)(txn.transactionDate).startOf('day');
-        return (txnDate.isSameOrAfter(periodStart, 'day') &&
-            txnDate.isSameOrBefore(periodEnd, 'day'));
-    });
-};
-const isStatementParseTransactionFieldChange = (changedField) => changedField === 'transactions' ||
-    changedField?.startsWith('transactions.') === true;
-exports.isStatementParseTransactionFieldChange = isStatementParseTransactionFieldChange;
-const isStatementParseBalanceAffectingTransactionFieldChange = (changedField) => {
-    if (changedField === 'transactions') {
-        return true;
-    }
-    if (changedField?.startsWith('transactions.') !== true) {
-        return false;
-    }
-    return !changedField.endsWith('.transactionMemo');
-};
-const isStatementParseManualBalanceField = (field) => field === 'totalDeposits' ||
-    field === 'totalPayments' ||
-    field === 'closingBalance';
-exports.isStatementParseManualBalanceField = isStatementParseManualBalanceField;
-const shouldRecalculateStatementParseBalances = (changedField) => isStatementParseBalanceAffectingTransactionFieldChange(changedField) ||
-    changedField === 'statementStartDate' ||
-    changedField === 'statementEndDate';
-exports.shouldRecalculateStatementParseBalances = shouldRecalculateStatementParseBalances;
-const resolveStatementParseBalanceFields = (formView, changedField, accountType) => {
-    const inPeriodTransactions = filterFormTransactionsInPeriod(formView.transactions, formView.statementStartDate, formView.statementEndDate);
-    const { totalDeposits, totalPayments } = computeStatementTransactionTotals(inPeriodTransactions);
-    if (!(0, exports.shouldRecalculateStatementParseBalances)(changedField)) {
-        return {
-            openingBalance: formView.openingBalance,
-            closingBalance: formView.closingBalance,
-            totalDeposits: formView.totalDeposits,
-            totalPayments: formView.totalPayments,
-        };
-    }
-    return {
-        openingBalance: formView.openingBalance,
-        totalDeposits,
-        totalPayments,
-        closingBalance: computeStatementClosingBalance(formView.openingBalance, totalDeposits, totalPayments, accountType),
-    };
-};
-exports.resolveStatementParseBalanceFields = resolveStatementParseBalanceFields;
-const areStatementParseBalancesConsistent = (formView, accountType) => {
-    // Validate the four balance fields against each other (what the user sees),
-    // not against recomputed transaction totals. Manual deposits/payments edits
-    // are allowed as long as closing matches the account-type formula.
-    return (roundCurrency(formView.closingBalance) ===
-        computeStatementClosingBalance(formView.openingBalance, formView.totalDeposits, formView.totalPayments, accountType));
-};
-exports.areStatementParseBalancesConsistent = areStatementParseBalancesConsistent;
-const mapParsedTransactionToFormRow = (transaction, index) => ({
-    id: transaction.statementTransactionId || `parsed-${index}`,
-    transactionDate: toApiDateString(transaction.transactionDate),
-    transactionMemo: transaction.transactionMemo,
-    amount: transaction.amount,
-    transactionDirection: transaction.transactionDirection,
-    statementTransactionId: transaction.statementTransactionId,
-});
-const mapLocalTransactionToFormRow = (transaction, id) => ({
-    id,
-    transactionDate: toApiDateString(transaction.transactionDate),
-    transactionMemo: transaction.transactionMemo,
-    amount: transaction.amount,
-    transactionDirection: transaction.transactionDirection,
-    statementTransactionId: transaction.statementTransactionId,
-});
-const buildStatementParseFormTransactions = (originalTransactions, localData) => {
-    const deletedIdSet = new Set(localData.statementTransactions?.deletedIds ?? []);
-    const updatedById = new Map((localData.statementTransactions?.updated ?? [])
-        .filter((transaction) => transaction.statementTransactionId != null)
-        .map((transaction) => [
-        transaction.statementTransactionId,
-        transaction,
-    ]));
-    const persistedTransactions = originalTransactions
-        .filter((transaction) => !deletedIdSet.has(transaction.statementTransactionId))
-        .map((transaction, index) => {
-        const updated = updatedById.get(transaction.statementTransactionId);
-        return updated != null
-            ? mapLocalTransactionToFormRow(updated, transaction.statementTransactionId)
-            : mapParsedTransactionToFormRow(transaction, index);
-    });
-    const addedTransactions = (localData.statementTransactions?.added ?? []).map((transaction, index) => mapLocalTransactionToFormRow(transaction, `added-${index}`));
-    return [...persistedTransactions, ...addedTransactions];
-};
 const mergeStatementParseDeletedTransactionIds = (originalTransactions, statementPeriod, currentTransactionIds) => {
     const dateFilteredDeletedIds = (0, exports.getDateFilteredDeletedTransactionIds)(originalTransactions, statementPeriod);
     const dateFilteredDeletedIdSet = new Set(dateFilteredDeletedIds);
@@ -200,119 +84,3 @@ const mergeStatementParseDeletedTransactionIds = (originalTransactions, statemen
     return [...new Set([...userDeletedIds, ...dateFilteredDeletedIds])];
 };
 exports.mergeStatementParseDeletedTransactionIds = mergeStatementParseDeletedTransactionIds;
-const resolveStatementMetaDates = (parsedStatementMeta, localMeta) => ({
-    statementStartDate: localMeta?.statementStartDate != null && localMeta.statementStartDate !== ''
-        ? localMeta.statementStartDate
-        : (parsedStatementMeta?.statementStartDate ?? ''),
-    statementEndDate: localMeta?.statementEndDate != null && localMeta.statementEndDate !== ''
-        ? localMeta.statementEndDate
-        : (parsedStatementMeta?.statementEndDate ?? ''),
-});
-const getStatementParseFormView = ({ accountType, parsedStatementMeta, originalTransactions, statementUpdateLocalData, }) => {
-    const transactions = statementUpdateLocalData != null
-        ? buildStatementParseFormTransactions(originalTransactions, statementUpdateLocalData)
-        : originalTransactions.map(mapParsedTransactionToFormRow);
-    const localMeta = statementUpdateLocalData?.statementMeta;
-    const { statementStartDate, statementEndDate } = resolveStatementMetaDates(parsedStatementMeta, localMeta);
-    const { totalDeposits, totalPayments } = computeStatementTransactionTotals(filterFormTransactionsInPeriod(transactions, statementStartDate, statementEndDate));
-    const openingBalance = localMeta?.openingBalance ?? parsedStatementMeta?.openingBalance ?? 0;
-    const computedClosingBalance = computeStatementClosingBalance(openingBalance, totalDeposits, totalPayments, accountType);
-    return {
-        statementStartDate,
-        statementEndDate,
-        openingBalance,
-        closingBalance: localMeta?.closingBalance ?? computedClosingBalance,
-        totalDeposits: localMeta?.totalDeposits ?? totalDeposits,
-        totalPayments: localMeta?.totalPayments ?? totalPayments,
-        transactions: filterFormTransactionsInPeriod(transactions, statementStartDate, statementEndDate),
-    };
-};
-exports.getStatementParseFormView = getStatementParseFormView;
-const toStatementUpdateLocalDataFromFormView = ({ accountType, formView, parsedStatementMeta, originalTransactions, changedField, }) => {
-    const balanceFields = (0, exports.resolveStatementParseBalanceFields)(formView, changedField, accountType);
-    const currentTransactionIds = new Set(formView.transactions
-        .map((transaction) => transaction.statementTransactionId)
-        .filter((id) => id != null && id !== ''));
-    const added = [];
-    const updated = [];
-    formView.transactions.forEach((transaction) => {
-        const transactionDate = toApiDateString(transaction.transactionDate);
-        if (transaction.statementTransactionId == null) {
-            if (transaction.transactionDirection != null) {
-                added.push({
-                    amount: transaction.amount,
-                    transactionDate,
-                    transactionDirection: transaction.transactionDirection,
-                    transactionMemo: transaction.transactionMemo,
-                });
-            }
-            return;
-        }
-        const original = originalTransactions.find((candidate) => candidate.statementTransactionId === transaction.statementTransactionId);
-        if (original != null &&
-            (original.amount !== transaction.amount ||
-                toApiDateString(original.transactionDate) !== transactionDate ||
-                original.transactionMemo !== transaction.transactionMemo)) {
-            updated.push({
-                amount: transaction.amount,
-                transactionDate,
-                transactionDirection: transaction.transactionDirection,
-                transactionMemo: transaction.transactionMemo,
-                statementTransactionId: transaction.statementTransactionId,
-            });
-        }
-    });
-    const statementPeriod = {
-        statementStartDate: toApiDateString(formView.statementStartDate),
-        statementEndDate: toApiDateString(formView.statementEndDate),
-    };
-    const deletedIds = (0, exports.mergeStatementParseDeletedTransactionIds)(originalTransactions, statementPeriod, currentTransactionIds);
-    const deletedIdSet = new Set(deletedIds);
-    const inPeriodAdded = filterFormTransactionsInPeriod(added, statementPeriod.statementStartDate, statementPeriod.statementEndDate);
-    const inPeriodUpdated = updated.filter((transaction) => transaction.statementTransactionId != null &&
-        !deletedIdSet.has(transaction.statementTransactionId));
-    return {
-        statementMeta: {
-            closingBalance: balanceFields.closingBalance,
-            openingBalance: balanceFields.openingBalance,
-            statementDataStatus: parsedStatementMeta?.statementDataStatus ?? {
-                code: '',
-                label: '',
-            },
-            statementEndDate: statementPeriod.statementEndDate,
-            statementStartDate: statementPeriod.statementStartDate,
-            statementStatus: parsedStatementMeta?.statementStatus ?? {
-                code: '',
-                label: '',
-            },
-            statementUploadId: parsedStatementMeta?.statementUploadId ?? '',
-            totalDeposits: balanceFields.totalDeposits,
-            totalPayments: balanceFields.totalPayments,
-        },
-        statementTransactions: {
-            added: inPeriodAdded,
-            deletedIds,
-            updated: inPeriodUpdated,
-        },
-    };
-};
-exports.toStatementUpdateLocalDataFromFormView = toStatementUpdateLocalDataFromFormView;
-const applyStatementParseFormChange = ({ accountType, formView, changedField, parsedStatementMeta, originalTransactions, }) => {
-    const balanceFields = (0, exports.resolveStatementParseBalanceFields)(formView, changedField, accountType);
-    const shouldRecalculate = (0, exports.shouldRecalculateStatementParseBalances)(changedField);
-    const mergedFormView = shouldRecalculate
-        ? { ...formView, ...balanceFields }
-        : formView;
-    return {
-        didRecalculateBalances: shouldRecalculate,
-        formView: mergedFormView,
-        localData: (0, exports.toStatementUpdateLocalDataFromFormView)({
-            accountType,
-            formView: mergedFormView,
-            parsedStatementMeta,
-            originalTransactions,
-            changedField,
-        }),
-    };
-};
-exports.applyStatementParseFormChange = applyStatementParseFormChange;

package/lib/view/expenseAutomationView/types/reconciliationViewState.d.ts

@@ -2,7 +2,7 @@ import { Amount } from '../../../commonStateTypes/amount';
 import { FetchStateAndError, ID } from '../../../commonStateTypes/common';
 import { SortOrder } from '../../../commonStateTypes/selectorTypes/sortOrderTypes';
 import { MonthYearPeriodId } from '../../../commonStateTypes/timePeriod';
-import { AccountType, ReconciliationAccountSourceType } from '../../../entity/account/accountState';
+import { ReconciliationAccountSourceType } from '../../../entity/account/accountState';
 import { BankStatusCodeType } from '../../../entity/accountRecon/accountReconState';
 import { CustomerBase } from '../../../entity/customer/customerState';
 import { VendorBase } from '../../../entity/vendor/vendorState';
@@ -251,6 +251,12 @@ export interface StatementTransactionForUpdate {
     transactionDate: string;
     transactionDirection: 'debit' | 'credit';
     transactionMemo: string;
+    /**
+     * Client-only stable id for unsaved added rows. Preserved across local-data
+     * rebuilds so form rows survive add/delete without index remapping. Not sent
+     * to the API.
+     */
+    id?: string;
     statementTransactionId?: string;
 }
 export interface StatementTransactionsUpdate {
@@ -258,49 +264,6 @@ export interface StatementTransactionsUpdate {
     deletedIds: string[];
     updated: StatementTransactionForUpdate[];
 }
-export type StatementParseManualBalanceField = 'totalDeposits' | 'totalPayments' | 'closingBalance';
-export interface StatementParseFormTransaction {
-    amount: number;
-    id: string;
-    transactionDate: string;
-    transactionDirection: 'debit' | 'credit';
-    transactionMemo: string;
-    statementTransactionId?: string;
-}
-export interface StatementParseFormView {
-    closingBalance: number;
-    openingBalance: number;
-    statementEndDate: string;
-    statementStartDate: string;
-    totalDeposits: number;
-    totalPayments: number;
-    transactions: StatementParseFormTransaction[];
-}
-export interface GetStatementParseFormViewInput {
-    originalTransactions: StatementTransaction[];
-    parsedStatementMeta: StatementMeta | undefined;
-    statementUpdateLocalData: StatementUpdateLocalData | undefined;
-    accountType?: AccountType;
-}
-export interface ToStatementUpdateLocalDataFromFormViewInput {
-    formView: StatementParseFormView;
-    originalTransactions: StatementTransaction[];
-    parsedStatementMeta: StatementMeta | undefined;
-    accountType?: AccountType;
-    changedField?: string;
-}
-export interface ApplyStatementParseFormChangeInput {
-    formView: StatementParseFormView;
-    originalTransactions: StatementTransaction[];
-    parsedStatementMeta: StatementMeta | undefined;
-    accountType?: AccountType;
-    changedField?: string;
-}
-export interface ApplyStatementParseFormChangeResult {
-    didRecalculateBalances: boolean;
-    formView: StatementParseFormView;
-    localData: StatementUpdateLocalData;
-}
 export interface StatementUpdateLocalData {
     statementMeta: StatementMeta;
     statementTransactions: StatementTransactionsUpdate;

package/lib/view/notificationPreferencesView/epics/saveNotificationPreferencesEpic.d.ts

@@ -0,0 +1,34 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { openSnackbar } from '../../../entity/snackbar/snackbarReducer';
+import { RootState } from '../../../reducer';
+import { ZeniAPI } from '../../../zeniAPI';
+import { saveNotificationPreferences, saveNotificationPreferencesFailure, saveNotificationPreferencesSuccess, setGroupFrequency, toggleEventChannel } from '../notificationPreferencesViewReducer';
+export type ActionType = ReturnType<typeof saveNotificationPreferences> | ReturnType<typeof saveNotificationPreferencesFailure> | ReturnType<typeof saveNotificationPreferencesSuccess> | ReturnType<typeof setGroupFrequency> | ReturnType<typeof toggleEventChannel> | ReturnType<typeof openSnackbar>;
+export declare const saveNotificationPreferencesEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<{
+    payload: {
+        messageSection: import("../../..").SnackbarMessageSections;
+        messageText: import("../../..").SnackbarMessageSectionTexts;
+        type: import("../../..").SnackbarMessageType;
+        showStatusIcon?: boolean;
+        variables?: {
+            variableName: string;
+            variableValue: string;
+        }[];
+    };
+    type: "snackbar/openSnackbar";
+} | {
+    payload: undefined;
+    type: "notificationPreferencesView/saveNotificationPreferences";
+} | {
+    payload: import("../notificationPreferencesViewReducer").SaveNotificationPreferencesFailurePayload;
+    type: "notificationPreferencesView/saveNotificationPreferencesFailure";
+} | {
+    payload: import("../notificationPreferencesViewReducer").SaveNotificationPreferencesSuccessPayload;
+    type: "notificationPreferencesView/saveNotificationPreferencesSuccess";
+} | {
+    payload: import("../notificationPreferencesViewReducer").SetFrequencyPayload;
+    type: "notificationPreferencesView/setGroupFrequency";
+} | {
+    payload: import("../notificationPreferencesViewReducer").TogglePreferencePayload;
+    type: "notificationPreferencesView/toggleEventChannel";
+}>;

package/lib/view/notificationPreferencesView/epics/saveNotificationPreferencesEpic.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveNotificationPreferencesEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const snackbarReducer_1 = require("../../../entity/snackbar/snackbarReducer");
+const responsePayload_1 = require("../../../responsePayload");
+const notificationPreferencesEndpoint_1 = require("../notificationPreferencesEndpoint");
+const notificationPreferencesViewPayload_1 = require("../notificationPreferencesViewPayload");
+const notificationPreferencesViewReducer_1 = require("../notificationPreferencesViewReducer");
+const notificationPreferencesViewSelector_1 = require("../notificationPreferencesViewSelector");
+const DEBOUNCE_MS = 300;
+const saveNotificationPreferencesEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)((action) => notificationPreferencesViewReducer_1.toggleEventChannel.match(action) || notificationPreferencesViewReducer_1.setGroupFrequency.match(action)), 
+// Coalesce bursts of toggles into a single PUT. Trade-off: rapid clickers
+// defer saves until they pause. Consider a max-wait wrapper if this
+// becomes a UX problem.
+(0, operators_1.debounceTime)(DEBOUNCE_MS), (0, operators_1.withLatestFrom)(state$), 
+// `switchMap` unsubscribes from any in-flight PUT observable when a new
+// debounced batch fires. The prior HTTP request has already left the
+// client — the network call is NOT cancelled — but its response is
+// ignored, so stale success/failure actions cannot clobber the newer
+// batch's state. Server-side ordering is arrival-order LWW.
+(0, operators_1.switchMap)(([, state]) => {
+    const overrides = (0, notificationPreferencesViewSelector_1.getNotificationLocalOverrides)(state);
+    const preferencesPatch = (0, notificationPreferencesViewPayload_1.mapPreferencesToPayload)(overrides);
+    if (Object.keys(preferencesPatch).length === 0) {
+        // No diff → do not dispatch a synthetic success (that would wipe
+        // stored preferences via the reducer). Simply no-op.
+        return rxjs_1.EMPTY;
+    }
+    // Snapshot the Cancel epoch at PUT-dispatch time. Every Cancel bumps
+    // `cancelEpoch`; the reducer compares the captured value on Success/
+    // Failure and skips the merge when the value has advanced (user
+    // pressed Cancel since this save started). See Cursor Bugbot 4aa021f7
+    // — the earlier counter model failed when `switchMap` abandoned an
+    // in-flight save's response (Success/Failure never dispatched, so
+    // the counter never drained and future saves got their merge dropped).
+    const cancelEpochAtDispatch = state.notificationPreferencesViewState.cancelEpoch;
+    const body = { task_checklist_preferences: preferencesPatch };
+    // Suppress the error snackbar when the response lands AFTER the user
+    // pressed Cancel — the Failure reducer already swallows the state
+    // update, so the toast would be a stale error for a save the user
+    // abandoned. `StateObservable#value` reads the current cancelEpoch at
+    // response time (not at dispatch time — that's what
+    // `cancelEpochAtDispatch` captures). Cursor Bugbot da2f4fe2 + Nikunj.
+    const errorSnackbar = (0, snackbarReducer_1.openSnackbar)({
+        messageSection: 'notification_settings_saved',
+        messageText: 'failed',
+        type: 'error',
+    });
+    const isCancelledSince = () => cancelEpochAtDispatch <
+        state$.value.notificationPreferencesViewState.cancelEpoch;
+    // Abort the in-flight HTTP request when `switchMap` disposes this
+    // observable (new debounced batch fires, tenant switch, unmount).
+    // Without an AbortSignal, `switchMap` would drop the response
+    // client-side but the older PUT would still land on the server —
+    // under patch-semantic LWW, a slower older PUT arriving after a
+    // newer one silently reverts the user's latest choice on the
+    // server. Cursor Bugbot e3861a76. `AbortController.abort()` is
+    // idempotent so it's safe if the request already completed.
+    const controller = new AbortController();
+    const request$ = zeniAPI
+        .putAndGetJSON((0, notificationPreferencesEndpoint_1.notificationPreferencesUrl)(zeniAPI), body, undefined, controller.signal)
+        .pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response)) {
+            return (0, rxjs_1.of)((0, notificationPreferencesViewReducer_1.saveNotificationPreferencesSuccess)({
+                cancelEpochAtDispatch,
+                savedOverrides: overrides,
+                serverEcho: response.data?.task_checklist_preferences,
+            }));
+        }
+        const actions = [
+            (0, notificationPreferencesViewReducer_1.saveNotificationPreferencesFailure)({
+                cancelEpochAtDispatch,
+                error: response.status,
+            }),
+        ];
+        if (!isCancelledSince()) {
+            // Surface a user-visible error — without it the UI reverts to
+            // server truth after debounce and the failed toggle looks like
+            // a mystery UI bug.
+            actions.push(errorSnackbar);
+        }
+        return (0, rxjs_1.of)(...actions);
+    }), (0, operators_1.catchError)((error) => {
+        const actions = [
+            (0, notificationPreferencesViewReducer_1.saveNotificationPreferencesFailure)({
+                cancelEpochAtDispatch,
+                error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Save notification preferences failed: ' +
+                    JSON.stringify(error)),
+            }),
+        ];
+        if (!isCancelledSince()) {
+            actions.push(errorSnackbar);
+        }
+        return (0, rxjs_1.of)(...actions);
+    }), (0, operators_1.finalize)(() => {
+        // switchMap disposal (new batch fires, cancel, unmount) → abort
+        // the still-in-flight HTTP request. No-op if the request has
+        // already completed successfully or errored.
+        controller.abort();
+    }));
+    // Flip savePreferencesState to In-Progress BEFORE the network call so
+    // any "saving…" UI can render.
+    return (0, rxjs_1.concat)((0, rxjs_1.of)((0, notificationPreferencesViewReducer_1.saveNotificationPreferences)()), request$);
+}));
+exports.saveNotificationPreferencesEpic = saveNotificationPreferencesEpic;

package/lib/view/notificationPreferencesView/notificationPreferencesEndpoint.d.ts

@@ -0,0 +1,2 @@
+import { ZeniAPI } from '../../zeniAPI';
+export declare const notificationPreferencesUrl: (zeniAPI: ZeniAPI) => string;

package/lib/view/notificationPreferencesView/notificationPreferencesEndpoint.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notificationPreferencesUrl = void 0;
+// Shared endpoint used by both the GET (envelope refresh in
+// `fetchNotificationSettingsEpic`) and the PUT (patch in
+// `saveNotificationPreferencesEpic`). Kept as a helper so an endpoint rename
+// can't drift between the two callers.
+const notificationPreferencesUrl = (zeniAPI) => `${zeniAPI.apiEndPoints.notificationMicroServiceBaseUrl}/1.0/notification-preferences`;
+exports.notificationPreferencesUrl = notificationPreferencesUrl;

package/lib/view/notificationPreferencesView/notificationPreferencesViewPayload.d.ts

@@ -0,0 +1,7 @@
+import { NotificationPreferences } from './notificationPreferencesViewState';
+export interface NotificationPreferencesPayload {
+    event_enabled_by_channel?: Record<string, Record<string, boolean>>;
+    group_frequency_by_group_id?: Record<string, string>;
+}
+export declare const mapPayloadToPreferences: (payload?: NotificationPreferencesPayload) => NotificationPreferences;
+export declare const mapPreferencesToPayload: (preferences: NotificationPreferences) => Record<string, unknown>;

package/lib/view/notificationPreferencesView/notificationPreferencesViewPayload.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapPreferencesToPayload = exports.mapPayloadToPreferences = void 0;
+const notificationRegistryState_1 = require("../../entity/notificationRegistry/notificationRegistryState");
+const mapEventEnabledByChannel = (raw) => {
+    if (raw == null) {
+        return {};
+    }
+    const out = {};
+    Object.entries(raw).forEach(([eventId, channelMap]) => {
+        const mapped = {};
+        Object.entries(channelMap).forEach(([channel, enabled]) => {
+            mapped[(0, notificationRegistryState_1.toNotificationChannel)(channel)] = enabled;
+        });
+        out[eventId] = mapped;
+    });
+    return out;
+};
+const mapPayloadToPreferences = (payload) => {
+    const groupFrequencyRaw = payload?.group_frequency_by_group_id ?? {};
+    const groupFrequencyByGroupId = Object.fromEntries(Object.entries(groupFrequencyRaw).map(([groupId, frequency]) => [
+        groupId,
+        (0, notificationRegistryState_1.toNotificationFrequency)(frequency),
+    ]));
+    return {
+        eventEnabledByChannel: mapEventEnabledByChannel(payload?.event_enabled_by_channel),
+        groupFrequencyByGroupId,
+    };
+};
+exports.mapPayloadToPreferences = mapPayloadToPreferences;
+const mapPreferencesToPayload = (preferences) => {
+    const payload = {};
+    if (Object.keys(preferences.eventEnabledByChannel).length > 0) {
+        payload.event_enabled_by_channel = preferences.eventEnabledByChannel;
+    }
+    if (Object.keys(preferences.groupFrequencyByGroupId).length > 0) {
+        payload.group_frequency_by_group_id = preferences.groupFrequencyByGroupId;
+    }
+    return payload;
+};
+exports.mapPreferencesToPayload = mapPreferencesToPayload;

package/lib/view/notificationPreferencesView/notificationPreferencesViewReducer.d.ts

@@ -0,0 +1,30 @@
+import { NotificationChannel, NotificationFrequency } from '../../entity/notificationRegistry/notificationRegistryState';
+import { ZeniAPIStatus } from '../../responsePayload';
+import { NotificationPreferencesPayload } from './notificationPreferencesViewPayload';
+import { NotificationPreferences, NotificationPreferencesViewState } from './notificationPreferencesViewState';
+export declare const initialState: NotificationPreferencesViewState;
+export interface SetFrequencyPayload {
+    frequency: NotificationFrequency;
+    groupId: string;
+}
+export interface TogglePreferencePayload {
+    channel: NotificationChannel;
+    enabled: boolean;
+    eventId: string;
+}
+export interface FetchNotificationPreferencesSuccessPayload {
+    preferences: NotificationPreferencesPayload | undefined;
+    saveEpochAtDispatch: number;
+}
+export interface SaveNotificationPreferencesSuccessPayload {
+    cancelEpochAtDispatch: number;
+    savedOverrides: NotificationPreferences;
+    serverEcho: NotificationPreferencesPayload | undefined;
+}
+export interface SaveNotificationPreferencesFailurePayload {
+    cancelEpochAtDispatch: number;
+    error?: ZeniAPIStatus;
+}
+export declare const clearAllNotificationPreferencesView: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"notificationPreferencesView/clearAllNotificationPreferencesView">, clearNotificationPreferencesLocalOverrides: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"notificationPreferencesView/clearNotificationPreferencesLocalOverrides">, fetchNotificationPreferencesSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<FetchNotificationPreferencesSuccessPayload, "notificationPreferencesView/fetchNotificationPreferencesSuccess">, saveNotificationPreferences: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"notificationPreferencesView/saveNotificationPreferences">, saveNotificationPreferencesFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<SaveNotificationPreferencesFailurePayload, "notificationPreferencesView/saveNotificationPreferencesFailure">, saveNotificationPreferencesSuccess: import("@reduxjs/toolkit").ActionCreatorWithPayload<SaveNotificationPreferencesSuccessPayload, "notificationPreferencesView/saveNotificationPreferencesSuccess">, setGroupFrequency: import("@reduxjs/toolkit").ActionCreatorWithPayload<SetFrequencyPayload, "notificationPreferencesView/setGroupFrequency">, toggleEventChannel: import("@reduxjs/toolkit").ActionCreatorWithPayload<TogglePreferencePayload, "notificationPreferencesView/toggleEventChannel">;
+declare const _default: import("redux").Reducer<NotificationPreferencesViewState>;
+export default _default;