@zeniai/client-epic-state 5.1.68-betaDI2 → 5.1.68-betaNB1

package/lib/view/expenseAutomationView/epics/accountRecon/confirmStatementMappingEpic.d.ts

@@ -0,0 +1,21 @@
+import { ActionsObservable, StateObservable } from 'redux-observable';
+import { RootState } from '../../../../reducer';
+import { ZeniAPI } from '../../../../zeniAPI';
+import { confirmStatementMapping, confirmStatementMappingFailure, confirmStatementMappingSuccess } from '../../reducers/reconciliationViewReducer';
+export type ActionType = ReturnType<typeof confirmStatementMapping> | ReturnType<typeof confirmStatementMappingSuccess> | ReturnType<typeof confirmStatementMappingFailure>;
+export declare const confirmStatementMappingEpic: (actions$: ActionsObservable<ActionType>, _state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => import("rxjs").Observable<{
+    payload: {
+        accountId: import("../../../..").ID;
+        selectedPeriod: import("../../../..").MonthYearPeriod;
+        statementUploads: import("../../types/reconciliationViewState").ConfirmedCombinedStatementUpload[];
+    };
+    type: "expenseAutomationReconciliationView/confirmStatementMappingSuccess";
+} | {
+    payload: {
+        accountId: import("../../../..").ID;
+        error: import("../../../../responsePayload").ZeniAPIStatus;
+        selectedPeriod: import("../../../..").MonthYearPeriod;
+        mappingConflict?: import("../../types/reconciliationViewState").ConfirmStatementMappingConflict | null;
+    };
+    type: "expenseAutomationReconciliationView/confirmStatementMappingFailure";
+}>;

package/lib/view/expenseAutomationView/epics/accountRecon/confirmStatementMappingEpic.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.confirmStatementMappingEpic = void 0;
+const rxjs_1 = require("rxjs");
+const operators_1 = require("rxjs/operators");
+const responsePayload_1 = require("../../../../responsePayload");
+const reconciliationPayload_1 = require("../../payload/reconciliationPayload");
+const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
+const confirmStatementMappingEpic = (actions$, _state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.confirmStatementMapping.match), (0, operators_1.switchMap)((action) => {
+    const { accountId, selectedPeriod, statementUploadId, accountMappings } = action.payload;
+    const confirmMappingApi$ = zeniAPI.postAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/1.0/reconciliation/statements/${statementUploadId}/confirm-mapping`, {
+        account_mappings: accountMappings.map((mapping) => ({
+            ledger_identifier: mapping.ledgerIdentifier,
+            account_id: mapping.accountId,
+        })),
+    });
+    return confirmMappingApi$.pipe((0, operators_1.mergeMap)((response) => {
+        if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.confirmStatementMappingSuccess)({
+                accountId,
+                selectedPeriod,
+                statementUploads: (0, reconciliationPayload_1.transformConfirmStatementMappingPayloadToState)(response.data),
+            }));
+        }
+        const mappingConflict = (0, reconciliationPayload_1.isConfirmStatementMappingConflictResponse)(response)
+            ? (0, reconciliationPayload_1.transformConfirmStatementMappingConflictToState)(response)
+            : null;
+        return (0, rxjs_1.of)((0, reconciliationViewReducer_1.confirmStatementMappingFailure)({
+            accountId,
+            selectedPeriod,
+            error: response.status,
+            mappingConflict,
+        }));
+    }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, reconciliationViewReducer_1.confirmStatementMappingFailure)({
+        accountId,
+        selectedPeriod,
+        error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Confirm Statement Mapping REST API call errored out ' +
+            (error instanceof Error ? error.message : String(error))),
+    }))));
+}));
+exports.confirmStatementMappingEpic = confirmStatementMappingEpic;

package/lib/view/expenseAutomationView/epics/accountRecon/updateStatementInfoEpic.js

@@ -7,15 +7,84 @@ const timePeriod_1 = require("../../../../commonStateTypes/timePeriod");
 const responsePayload_1 = require("../../../../responsePayload");
 const mapStatementUpdateLocalDataToRequestBody_1 = require("../../helpers/mapStatementUpdateLocalDataToRequestBody");
 const reconciliationPayload_1 = require("../../payload/reconciliationPayload");
+const statementParseViewSelector_1 = require("../../selectors/statementParseViewSelector");
 const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
 const updateStatementInfoEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.submitStatementUpdate.match), (0, operators_1.switchMap)((action) => {
     const { accountId, selectedPeriod, statementUploadId } = action.payload;
     const state = state$.value;
     const reconciliationView = state.expenseAutomationReconciliationViewState;
     const accountRecon = reconciliationView.accountReconciliationRecordsBySelectedPeriod[(0, timePeriod_1.toMonthYearPeriodId)(selectedPeriod)]?.reconciliationByAccountID[accountId];
-    const localData = accountRecon?.localData?.statementUpdateLocalData;
     const parsedStatementData = accountRecon?.parsedStatementData;
-    if (localData == null || parsedStatementData == null) {
+    const isCombined = (0, statementParseViewSelector_1.isCombinedParsedStatementData)(parsedStatementData) === true;
+    const localDataByUploadId = accountRecon?.localData?.statementUpdateLocalDataByUploadId;
+    const localData = accountRecon?.localData?.statementUpdateLocalData;
+    if (parsedStatementData == null) {
+        return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+            accountId,
+            selectedPeriod,
+            error: (0, responsePayload_1.createZeniAPIStatus)('Missing Data', 'No statement update data found'),
+        }));
+    }
+    if (isCombined === true) {
+        if ((0, mapStatementUpdateLocalDataToRequestBody_1.hasCombinedStatementUpdateLocalData)(parsedStatementData, localDataByUploadId) === false ||
+            localDataByUploadId == null) {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+                accountId,
+                selectedPeriod,
+                error: (0, responsePayload_1.createZeniAPIStatus)('Missing Data', 'No statement update data found for combined accounts'),
+            }));
+        }
+        const hasInvalidUpdates = Object.values(localDataByUploadId).some((uploadLocalData) => uploadLocalData.statementTransactions.updated.some((txn) => txn.statementTransactionId == null));
+        if (hasInvalidUpdates === true) {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+                accountId,
+                selectedPeriod,
+                error: (0, responsePayload_1.createZeniAPIStatus)('Invalid Data', 'One or more edited transactions are missing statement transaction ids'),
+            }));
+        }
+        let body;
+        try {
+            body = (0, mapStatementUpdateLocalDataToRequestBody_1.mapCombinedStatementUpdateLocalDataToRequestBody)(localDataByUploadId, parsedStatementData);
+        }
+        catch (error) {
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+                accountId,
+                selectedPeriod,
+                error: (0, responsePayload_1.createZeniAPIStatus)('Missing Data', error instanceof Error
+                    ? error.message
+                    : 'Failed to build combined statement update body'),
+            }));
+        }
+        const updateStatementApi$ = zeniAPI.putAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/2.0/statement-uploads/${statementUploadId}`, body);
+        return updateStatementApi$.pipe((0, operators_1.mergeMap)((response) => {
+            if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
+                const nextParsedStatementData = (0, reconciliationPayload_1.transformUpdateStatementInfoPayloadToState)(response.data);
+                return (0, rxjs_1.of)((0, reconciliationViewReducer_1.updateParsedStatementData)({
+                    accountId,
+                    selectedPeriod,
+                    parsedStatementData: nextParsedStatementData,
+                }), (0, reconciliationViewReducer_1.submitStatementUpdateSuccess)({
+                    accountId,
+                    selectedPeriod,
+                }));
+            }
+            const dateConflict = (0, reconciliationPayload_1.isStatementDateConflictResponse)(response)
+                ? (0, reconciliationPayload_1.transformStatementDateConflictToState)(response)
+                : null;
+            return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+                accountId,
+                selectedPeriod,
+                error: response.status,
+                dateConflict,
+            }));
+        }), (0, operators_1.catchError)((error) => (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
+            accountId,
+            selectedPeriod,
+            error: (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', 'Update Statement REST API call errored out ' +
+                (error instanceof Error ? error.message : String(error))),
+        }))));
+    }
+    if (localData == null) {
         return (0, rxjs_1.of)((0, reconciliationViewReducer_1.submitStatementUpdateFailure)({
             accountId,
             selectedPeriod,
@@ -34,11 +103,11 @@ const updateStatementInfoEpic = (actions$, state$, zeniAPI) => actions$.pipe((0,
     const updateStatementApi$ = zeniAPI.putAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/2.0/statement-uploads/${statementUploadId}`, body);
     return updateStatementApi$.pipe((0, operators_1.mergeMap)((response) => {
         if ((0, responsePayload_1.isSuccessResponse)(response) === true && response.data != null) {
-            const parsedStatementData = (0, reconciliationPayload_1.transformUpdateStatementInfoPayloadToState)(response.data);
+            const nextParsedStatementData = (0, reconciliationPayload_1.transformUpdateStatementInfoPayloadToState)(response.data);
             return (0, rxjs_1.of)((0, reconciliationViewReducer_1.updateParsedStatementData)({
                 accountId,
                 selectedPeriod,
-                parsedStatementData,
+                parsedStatementData: nextParsedStatementData,
             }), (0, reconciliationViewReducer_1.submitStatementUpdateSuccess)({
                 accountId,
                 selectedPeriod,

package/lib/view/expenseAutomationView/epics/accountRecon/uploadAccountStatementDocumentAIHelper.d.ts

@@ -10,4 +10,4 @@ export interface AuthParamsPayload {
     zeni_tenant_id: string;
     zeni_user_id: string;
 }
-export default function uploadAccountStatementIntoDocumentAI(accountType: AccountType, fileBlob: Blob, authParams: AuthParams): Promise<UploadStatementDocumentAIPayload | undefined>;
+export default function uploadAccountStatementIntoDocumentAI(accountType: AccountType, fileBlob: Blob, authParams: AuthParams, isCombinedStatement?: boolean): Promise<UploadStatementDocumentAIPayload | undefined>;

package/lib/view/expenseAutomationView/epics/accountRecon/uploadAccountStatementDocumentAIHelper.js

@@ -6,15 +6,23 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = uploadAccountStatementIntoDocumentAI;
 const cross_fetch_1 = __importDefault(require("cross-fetch"));
 const init_1 = require("../../../../init");
-async function uploadAccountStatementIntoDocumentAI(accountType, fileBlob, authParams) {
+function toStatementDocumentType(accountType, isCombinedStatement) {
+    if (isCombinedStatement === true) {
+        return accountType === 'credit_card'
+            ? 'reconciliation_combined_card_statement_upload'
+            : 'reconciliation_combined_bank_statement_upload';
+    }
+    return accountType === 'credit_card'
+        ? 'reconciliation_card_statement_upload'
+        : 'reconciliation_bank_statement_upload';
+}
+async function uploadAccountStatementIntoDocumentAI(accountType, fileBlob, authParams, isCombinedStatement = false) {
     let statementUpload;
     const urlEndPoint = `${init_1.zeniAPI.apiEndPoints.documentAIMicroServiceBaseUrl}/1.0/processors/statement`;
     const data = new FormData();
     data.append('attachment_file_0', fileBlob);
     const attachment_json = JSON.stringify({
-        document_type: accountType === 'credit_card'
-            ? 'reconciliation_card_statement_upload'
-            : 'reconciliation_bank_statement_upload',
+        document_type: toStatementDocumentType(accountType, isCombinedStatement),
         purpose_id: 'reconciliation',
     });
     data.append('attachment_json_0', attachment_json);

package/lib/view/expenseAutomationView/epics/accountRecon/uploadAccountStatementEpic.js

@@ -11,7 +11,7 @@ const fileReducer_1 = require("../../../../entity/file/fileReducer");
 const responsePayload_1 = require("../../../../responsePayload");
 const reconciliationViewReducer_1 = require("../../reducers/reconciliationViewReducer");
 const uploadAccountStatementEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(reconciliationViewReducer_1.uploadAccountStatement.match), (0, operators_1.mergeMap)((action) => {
-    const { accountId, selectedPeriod, payload } = action.payload;
+    const { accountId, selectedPeriod, payload, statementAccountScope } = action.payload;
     const { start, end } = (0, timePeriod_1.convertToPeriod)(selectedPeriod, true);
     const accountBase = (0, accountSelector_1.getAccountBase)(state$.value.accountState, accountId, 'account_reconciliation');
     if (accountBase == null) {
@@ -22,6 +22,13 @@ const uploadAccountStatementEpic = (actions$, state$, zeniAPI) => actions$.pipe(
         }));
     }
     const statementType = accountBase.accountType == 'credit_card' ? 'card' : 'bank';
+    const localStatementAccountScope = state$.value.expenseAutomationReconciliationViewState
+        .accountReconciliationRecordsBySelectedPeriod[(0, timePeriod_1.toMonthYearPeriodId)(selectedPeriod)]?.reconciliationByAccountID[accountId]?.localData
+        ?.statementAccountScope;
+    const resolvedStatementAccountScope = statementAccountScope ??
+        localStatementAccountScope ??
+        'single_account';
+    const isCombinedStatement = resolvedStatementAccountScope === 'multi_account';
     const requestPayload = {
         account_id: accountId,
         statement_start_date: start.toString(),
@@ -29,6 +36,7 @@ const uploadAccountStatementEpic = (actions$, state$, zeniAPI) => actions$.pipe(
         processor_run_id: payload.processor_run_id,
         file_id: payload.files[0].file_id,
         statement_type: statementType,
+        is_combined_statement: isCombinedStatement,
     };
     const uploadAccountStatementApi$ = zeniAPI.postAndGetJSON(`${zeniAPI.apiEndPoints.reconciliationMicroServiceBaseUrl}/1.0/reconciliation/statements`, requestPayload);
     return uploadAccountStatementApi$.pipe((0, operators_1.mergeMap)((response) => {

package/lib/view/expenseAutomationView/helpers/mapStatementUpdateLocalDataToRequestBody.d.ts

@@ -1,2 +1,4 @@
 import { ParsedStatementData, StatementUpdateLocalData } from '../types/reconciliationViewState';
 export declare const mapStatementUpdateLocalDataToRequestBody: (localData: StatementUpdateLocalData, parsedStatementData: ParsedStatementData) => Record<string, unknown>;
+export declare const mapCombinedStatementUpdateLocalDataToRequestBody: (localDataByUploadId: Record<string, StatementUpdateLocalData>, parsedStatementData: ParsedStatementData) => Record<string, unknown>;
+export declare const hasCombinedStatementUpdateLocalData: (parsedStatementData: ParsedStatementData | undefined, localDataByUploadId: Record<string, StatementUpdateLocalData> | undefined) => boolean;

package/lib/view/expenseAutomationView/helpers/mapStatementUpdateLocalDataToRequestBody.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.mapStatementUpdateLocalDataToRequestBody = void 0;
+exports.hasCombinedStatementUpdateLocalData = exports.mapCombinedStatementUpdateLocalDataToRequestBody = exports.mapStatementUpdateLocalDataToRequestBody = void 0;
 const reconciliationPayload_1 = require("../payload/reconciliationPayload");
 const statementParseViewSelector_1 = require("../selectors/statementParseViewSelector");
-const prepareStatementUpdateLocalData = (localData, parsedStatementData) => {
-    const { statementMeta, statementTransactions } = parsedStatementData.statementUpload;
+const prepareStatementUpdateLocalData = (localData, statementUpload) => {
+    const { statementMeta, statementTransactions } = statementUpload;
     const statementPeriod = (0, statementParseViewSelector_1.getEffectiveStatementPeriod)(statementMeta, localData.statementMeta);
     const localDeletedIds = localData.statementTransactions?.deletedIds ?? [];
     const currentTransactionIds = new Set(statementTransactions
@@ -30,5 +30,31 @@ const prepareStatementUpdateLocalData = (localData, parsedStatementData) => {
         },
     };
 };
-const mapStatementUpdateLocalDataToRequestBody = (localData, parsedStatementData) => (0, reconciliationPayload_1.toStatementUpdateRequestBody)(prepareStatementUpdateLocalData(localData, parsedStatementData));
+const mapStatementUpdateLocalDataToRequestBody = (localData, parsedStatementData) => (0, reconciliationPayload_1.toStatementUpdateRequestBody)(prepareStatementUpdateLocalData(localData, parsedStatementData.statementUpload));
 exports.mapStatementUpdateLocalDataToRequestBody = mapStatementUpdateLocalDataToRequestBody;
+const mapCombinedStatementUpdateLocalDataToRequestBody = (localDataByUploadId, parsedStatementData) => {
+    const statementUploads = (0, statementParseViewSelector_1.getStatementUploadsFromParsedData)(parsedStatementData);
+    const updates = statementUploads.map((statementUpload) => {
+        const statementUploadId = statementUpload.statementMeta.statementUploadId;
+        const localData = localDataByUploadId[statementUploadId];
+        if (localData == null) {
+            throw new Error(`Missing statement update local data for upload ${statementUploadId}`);
+        }
+        return {
+            statementUploadId,
+            localData: prepareStatementUpdateLocalData(localData, statementUpload),
+        };
+    });
+    return (0, reconciliationPayload_1.toBulkStatementUpdateRequestBody)(updates);
+};
+exports.mapCombinedStatementUpdateLocalDataToRequestBody = mapCombinedStatementUpdateLocalDataToRequestBody;
+const hasCombinedStatementUpdateLocalData = (parsedStatementData, localDataByUploadId) => {
+    if ((0, statementParseViewSelector_1.isCombinedParsedStatementData)(parsedStatementData) === false ||
+        localDataByUploadId == null) {
+        return false;
+    }
+    const statementUploads = (0, statementParseViewSelector_1.getStatementUploadsFromParsedData)(parsedStatementData);
+    return statementUploads.every((statementUpload) => localDataByUploadId[statementUpload.statementMeta.statementUploadId] !=
+        null);
+};
+exports.hasCombinedStatementUpdateLocalData = hasCombinedStatementUpdateLocalData;

package/lib/view/expenseAutomationView/payload/reconciliationPayload.d.ts

@@ -9,7 +9,7 @@ import { MatchedTransactionPayload } from '../../../entity/transaction/payloadTy
 import { UserPayload } from '../../../entity/user/userPayload';
 import { RootState } from '../../../reducer';
 import { ZeniAPIResponse, ZeniAPIStatus } from '../../../responsePayload';
-import { BalancesLocalData, ParsedStatementData, SaveReconcileDetailActionPayload, StatementDateConflict, StatementUpdateLocalData, StatementUpdateLocalDataPayload } from '../types/reconciliationViewState';
+import { BalancesLocalData, ConfirmStatementMappingConflict, ConfirmedCombinedStatementUpload, ParsedStatementData, SaveReconcileDetailActionPayload, StatementDateConflict, StatementUpdateLocalData, StatementUpdateLocalDataPayload } from '../types/reconciliationViewState';
 export interface DetectionInfoPayload {
     account_id: string;
     bank_balance: number | null;
@@ -119,6 +119,9 @@ export interface StatementUploadSummaryPayload {
     statement_start_date: string;
     statement_status: StatusCodeWithLabelPayload;
     statement_upload_id: string;
+    combined_statement_group_id?: string | null;
+    is_combined_statement?: boolean | null;
+    is_combined_statement_anchor?: boolean | null;
 }
 export interface UploadStatementResponsePayload {
     file: FilePayload;
@@ -162,6 +165,10 @@ export interface StatementMetaPayload {
     statement_upload_id: string;
     total_deposits: number;
     total_payments: number;
+    balance_source?: string | null;
+    combined_statement_group_id?: string | null;
+    is_combined_statement?: boolean | null;
+    is_combined_statement_anchor?: boolean | null;
 }
 export interface AccountInfoPayload {
     account_id: string;
@@ -199,17 +206,75 @@ export interface AiSummaryPayload {
     fields_captured: AiSummaryFieldPayload[];
     transactions_extracted: number;
 }
+export interface CombinedStatementAccountSuggestionPayload {
+    account_id: string;
+    account_name: string;
+    match_confidence: number;
+    matched_by: string;
+}
+export interface CombinedStatementAccountPayload {
+    account_name: string;
+    account_type: string;
+    closing_balance: number;
+    is_upload_context: boolean;
+    ledger_identifier: string;
+    masked_account_number: string;
+    opening_balance: number;
+    transaction_count: number;
+    existing_statement_status?: StatusCodeWithLabelPayload | null;
+    suggestion?: CombinedStatementAccountSuggestionPayload | null;
+}
+export interface ConfirmedCombinedStatementUploadPayload {
+    account_id: string;
+    is_combined_statement_anchor: boolean;
+    ledger_identifiers: string[];
+    statement_upload_id: string;
+}
+export interface CombinedStatementDetailsPayload {
+    accounts: CombinedStatementAccountPayload[];
+    combined_statement_group_id: string;
+    is_mapping_confirmed: boolean;
+    statement_uploads: ConfirmedCombinedStatementUploadPayload[];
+}
 export interface StatementUploadPayload {
     account: AccountInfoPayload;
     file: FileInfoPayload | null;
     statement_meta: StatementMetaPayload;
     statement_transactions: StatementTransactionPayload[];
     ai_summary?: AiSummaryPayload | null;
+    combined_statement_details?: CombinedStatementDetailsPayload | null;
 }
-export interface ParseStatementResponsePayload {
-    reconciliation: ReconciliationMetaPayload;
+/** Single-account parse GET — unchanged. */
+export interface ParseStatementSingleResponsePayload {
+    reconciliation: ReconciliationMetaPayload | null;
     statement_upload: StatementUploadPayload;
 }
+/** Combined multi-account parse GET (after mapping confirm). */
+export interface ParseStatementCombinedResponsePayload {
+    reconciliation: ReconciliationMetaPayload | null;
+    statement_uploads: StatementUploadPayload[];
+}
+export type ParseStatementResponsePayload = ParseStatementSingleResponsePayload | ParseStatementCombinedResponsePayload;
+export declare function isParseStatementCombinedResponsePayload(payload: ParseStatementResponsePayload): payload is ParseStatementCombinedResponsePayload;
+export interface ConfirmStatementMappingRequestPayload {
+    account_mappings: Array<{
+        account_id: string;
+        ledger_identifier: string;
+    }>;
+}
+export interface ConfirmStatementMappingResponsePayload {
+    statement_uploads: ConfirmedCombinedStatementUploadPayload[];
+}
+export type ConfirmStatementMappingSuccessResponse = ZeniAPIResponse<ConfirmStatementMappingResponsePayload>;
+export interface ConfirmStatementMappingConflictResponse extends ZeniAPIResponse<ConfirmStatementMappingResponsePayload | undefined> {
+    status: ZeniAPIStatus & {
+        code: 409;
+    };
+    colliding_account_id?: string | null;
+    colliding_ledger_identifiers?: string[] | null;
+    previous_reconciliation_info?: PreviousReconciliationInfoPayload | null;
+}
+export type ConfirmStatementMappingResponse = ConfirmStatementMappingSuccessResponse | ConfirmStatementMappingConflictResponse;
 export interface ReparseStatementResponsePayload {
     statement_upload: StatementUploadSummaryPayload;
 }
@@ -232,11 +297,28 @@ export interface StatementDateAdjustmentPayload {
     previous_reconciliation_info: PreviousReconciliationInfoPayload;
     reason: string;
 }
-export interface UpdateStatementInfoResponsePayload {
+/** Single-account Confirm & Save response — unchanged. */
+export interface UpdateStatementInfoSingleResponsePayload {
     reconciliation: ReconciliationMetaPayload;
     statement_upload: StatementUploadPayload;
     date_adjustment?: StatementDateAdjustmentPayload | null;
 }
+/** Combined multi-account bulk Confirm & Save response. */
+export interface UpdateStatementInfoCombinedResponsePayload {
+    reconciliation: ReconciliationMetaPayload;
+    statement_uploads: StatementUploadPayload[];
+    date_adjustment?: StatementDateAdjustmentPayload | null;
+}
+export type UpdateStatementInfoResponsePayload = UpdateStatementInfoSingleResponsePayload | UpdateStatementInfoCombinedResponsePayload;
+export declare function isUpdateStatementInfoCombinedResponsePayload(payload: UpdateStatementInfoResponsePayload): payload is UpdateStatementInfoCombinedResponsePayload;
+export interface BulkStatementUpdateUploadPayload {
+    statement_meta: StatementUpdateLocalDataPayload['statement_meta'];
+    statement_transactions: StatementUpdateLocalDataPayload['statement_transactions'];
+    statement_upload_id: string;
+}
+export interface BulkStatementUpdateRequestPayload {
+    statement_uploads: BulkStatementUpdateUploadPayload[];
+}
 /** 2xx Confirm & Save — carries parsed statement data, no chain-validation errors. */
 export interface UpdateStatementInfoSuccessResponse extends ZeniAPIResponse<UpdateStatementInfoResponsePayload> {
     error_code?: undefined;
@@ -260,8 +342,20 @@ export declare function isStatementDateConflictResponse(response: UpdateStatemen
  */
 export declare function transformStatementDateConflictToState(response: UpdateStatementInfoResponse): StatementDateConflict | null;
 export declare function transformParseStatementPayloadToState(payload: ParseStatementResponsePayload): ParsedStatementData;
+export declare function isConfirmStatementMappingConflictResponse(response: ConfirmStatementMappingResponse): response is ConfirmStatementMappingConflictResponse;
+export declare function transformConfirmStatementMappingPayloadToState(payload: ConfirmStatementMappingResponsePayload): ConfirmedCombinedStatementUpload[];
+export declare function transformConfirmStatementMappingConflictToState(response: ConfirmStatementMappingResponse): ConfirmStatementMappingConflict | null;
 export declare function transformUpdateStatementInfoPayloadToState(payload: UpdateStatementInfoResponsePayload): ParsedStatementData;
 export declare function transformStatementUpdateStateToPayload(localData: StatementUpdateLocalData): StatementUpdateLocalDataPayload;
 /** API request body for PUT statement-uploads; cast lives here for putAndGetJSON. */
 export declare function toStatementUpdateRequestBody(localData: StatementUpdateLocalData): Record<string, unknown>;
+export declare function transformBulkStatementUpdateStateToPayload(updates: Array<{
+    localData: StatementUpdateLocalData;
+    statementUploadId: string;
+}>): BulkStatementUpdateRequestPayload;
+/** Bulk PUT body for combined multi-account Confirm & Save. */
+export declare function toBulkStatementUpdateRequestBody(updates: Array<{
+    localData: StatementUpdateLocalData;
+    statementUploadId: string;
+}>): Record<string, unknown>;
 export {};

package/lib/view/expenseAutomationView/payload/reconciliationPayload.js

@@ -1,15 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createSaveReconciliationPayloadBasedOnActionAndMethod = createSaveReconciliationPayloadBasedOnActionAndMethod;
+exports.isParseStatementCombinedResponsePayload = isParseStatementCombinedResponsePayload;
+exports.isUpdateStatementInfoCombinedResponsePayload = isUpdateStatementInfoCombinedResponsePayload;
 exports.isStatementDateConflictResponse = isStatementDateConflictResponse;
 exports.transformStatementDateConflictToState = transformStatementDateConflictToState;
 exports.transformParseStatementPayloadToState = transformParseStatementPayloadToState;
+exports.isConfirmStatementMappingConflictResponse = isConfirmStatementMappingConflictResponse;
+exports.transformConfirmStatementMappingPayloadToState = transformConfirmStatementMappingPayloadToState;
+exports.transformConfirmStatementMappingConflictToState = transformConfirmStatementMappingConflictToState;
 exports.transformUpdateStatementInfoPayloadToState = transformUpdateStatementInfoPayloadToState;
 exports.transformStatementUpdateStateToPayload = transformStatementUpdateStateToPayload;
 exports.toStatementUpdateRequestBody = toStatementUpdateRequestBody;
+exports.transformBulkStatementUpdateStateToPayload = transformBulkStatementUpdateStateToPayload;
+exports.toBulkStatementUpdateRequestBody = toBulkStatementUpdateRequestBody;
 const timePeriod_1 = require("../../../commonStateTypes/timePeriod");
 const accountReconPayload_1 = require("../../../entity/accountRecon/accountReconPayload");
 const reconciliationTransactionPayloads_1 = require("../../../entity/transaction/payloadTypes/reconciliationTransactionPayloads");
+const reconciliationViewState_1 = require("../types/reconciliationViewState");
 function createSaveReconciliationPayloadBasedOnActionAndMethod(state, selectedPeriod, localData, accountReconciliationEntity, action, method) {
     const { balance, initialClearedBalance } = accountReconciliationEntity;
     const { expenseAutomationReconciliationViewState: { selectedAccountId, reconTabsState: { reconcile: { localData: { selectedTransactionIds }, }, }, }, } = state;
@@ -76,10 +84,58 @@ function createReviewTransactionPayload(accountReconciliationEntity) {
     });
     return reviewTransactionsPayload;
 }
+function isParseStatementCombinedResponsePayload(payload) {
+    return ('statement_uploads' in payload &&
+        Array.isArray(payload.statement_uploads) &&
+        payload.statement_uploads.length > 0);
+}
+function isUpdateStatementInfoCombinedResponsePayload(payload) {
+    return ('statement_uploads' in payload &&
+        Array.isArray(payload.statement_uploads) &&
+        payload.statement_uploads.length > 0);
+}
 function isStatementDateConflictResponse(response) {
     return response.status.code === 409 && response.error_code != null;
 }
+function transformConfirmedCombinedStatementUploadsToState(statementUploads) {
+    return (statementUploads ?? []).map((statementUpload) => ({
+        accountId: statementUpload.account_id,
+        isCombinedStatementAnchor: statementUpload.is_combined_statement_anchor,
+        ledgerIdentifiers: statementUpload.ledger_identifiers ?? [],
+        statementUploadId: statementUpload.statement_upload_id,
+    }));
+}
+function transformCombinedStatementDetailsToState(details) {
+    if (details == null) {
+        return undefined;
+    }
+    return {
+        combinedStatementGroupId: details.combined_statement_group_id,
+        isMappingConfirmed: details.is_mapping_confirmed,
+        accounts: (details.accounts ?? []).map((account) => ({
+            ledgerIdentifier: account.ledger_identifier,
+            accountName: account.account_name,
+            accountType: account.account_type,
+            maskedAccountNumber: account.masked_account_number,
+            openingBalance: account.opening_balance,
+            closingBalance: account.closing_balance,
+            transactionCount: account.transaction_count,
+            isUploadContext: account.is_upload_context,
+            existingStatementStatus: account.existing_statement_status ?? null,
+            suggestion: account.suggestion != null
+                ? {
+                    accountId: account.suggestion.account_id,
+                    accountName: account.suggestion.account_name,
+                    matchedBy: account.suggestion.matched_by,
+                    matchConfidence: account.suggestion.match_confidence,
+                }
+                : null,
+        })),
+        statementUploads: transformConfirmedCombinedStatementUploadsToState(details.statement_uploads),
+    };
+}
 function transformStatementUploadPayloadToState(statementUploadPayload) {
+    const balanceSource = (0, reconciliationViewState_1.toStatementBalanceSourceStrict)(statementUploadPayload.statement_meta.balance_source);
     return {
         account: {
             accountId: statementUploadPayload.account.account_id,
@@ -105,6 +161,12 @@ function transformStatementUploadPayloadToState(statementUploadPayload) {
             statementUploadId: statementUploadPayload.statement_meta.statement_upload_id,
             totalDeposits: statementUploadPayload.statement_meta.total_deposits,
             totalPayments: statementUploadPayload.statement_meta.total_payments,
+            isCombinedStatement: statementUploadPayload.statement_meta.is_combined_statement ??
+                undefined,
+            isCombinedStatementAnchor: statementUploadPayload.statement_meta.is_combined_statement_anchor ??
+                undefined,
+            combinedStatementGroupId: statementUploadPayload.statement_meta.combined_statement_group_id ?? undefined,
+            ...(balanceSource != null ? { balanceSource } : {}),
         },
         statementTransactions: (statementUploadPayload.statement_transactions ?? []).map((txn) => ({
             amount: txn.amount,
@@ -126,6 +188,7 @@ function transformStatementUploadPayloadToState(statementUploadPayload) {
             transactionMemo: txn.transaction_memo,
         })),
         aiSummary: transformAiSummaryPayloadToState(statementUploadPayload.ai_summary),
+        combinedStatementDetails: transformCombinedStatementDetailsToState(statementUploadPayload.combined_statement_details),
     };
 }
 function transformPreviousReconciliationInfoToState(payload) {
@@ -186,11 +249,45 @@ function transformStatementDateConflictToState(response) {
     };
 }
 function transformParseStatementPayloadToState(payload) {
+    if (isParseStatementCombinedResponsePayload(payload) === true) {
+        const statementUploads = payload.statement_uploads.map(transformStatementUploadPayloadToState);
+        const anchorUpload = statementUploads.find((upload) => upload.statementMeta.isCombinedStatementAnchor === true) ?? statementUploads[0];
+        return {
+            statementUpload: anchorUpload,
+            statementUploads,
+        };
+    }
     return {
         statementUpload: transformStatementUploadPayloadToState(payload.statement_upload),
     };
 }
+function isConfirmStatementMappingConflictResponse(response) {
+    return response.status.code === 409;
+}
+function transformConfirmStatementMappingPayloadToState(payload) {
+    return transformConfirmedCombinedStatementUploadsToState(payload.statement_uploads);
+}
+function transformConfirmStatementMappingConflictToState(response) {
+    if (isConfirmStatementMappingConflictResponse(response) === false) {
+        return null;
+    }
+    return {
+        collidingAccountId: response.colliding_account_id != null
+            ? response.colliding_account_id
+            : undefined,
+        collidingLedgerIdentifiers: response.colliding_ledger_identifiers ?? [],
+        previousReconciliationInfo: transformPreviousReconciliationInfoToState(response.previous_reconciliation_info),
+    };
+}
 function transformUpdateStatementInfoPayloadToState(payload) {
+    if (isUpdateStatementInfoCombinedResponsePayload(payload) === true) {
+        const statementUploads = payload.statement_uploads.map(transformStatementUploadPayloadToState);
+        const anchorUpload = statementUploads.find((upload) => upload.statementMeta.isCombinedStatementAnchor === true) ?? statementUploads[0];
+        return {
+            statementUpload: anchorUpload,
+            statementUploads,
+        };
+    }
     return {
         statementUpload: transformStatementUploadPayloadToState(payload.statement_upload),
     };
@@ -230,3 +327,19 @@ function transformStatementUpdateStateToPayload(localData) {
 function toStatementUpdateRequestBody(localData) {
     return transformStatementUpdateStateToPayload(localData);
 }
+function transformBulkStatementUpdateStateToPayload(updates) {
+    return {
+        statement_uploads: updates.map(({ localData, statementUploadId }) => {
+            const body = transformStatementUpdateStateToPayload(localData);
+            return {
+                statement_upload_id: statementUploadId,
+                statement_meta: body.statement_meta,
+                statement_transactions: body.statement_transactions,
+            };
+        }),
+    };
+}
+/** Bulk PUT body for combined multi-account Confirm & Save. */
+function toBulkStatementUpdateRequestBody(updates) {
+    return transformBulkStatementUpdateStateToPayload(updates);
+}