@zeniai/client-epic-state 5.2.14 → 5.2.16

package/lib/entity/accountRecon/accountReconReducer.d.ts

@@ -3,9 +3,10 @@ import { DeleteStatementResponsePayload, ReparseStatementResponsePayload, Upload
 import { ReconciliationDataPayload } from './accountReconPayload';
 import { AccountReconState } from './accountReconState';
 export declare const initialState: AccountReconState;
-export declare const updateAccountRecon: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[selectedPeriod: MonthYearPeriod, accountReconDataPayload: ReconciliationDataPayload[]], {
+export declare const updateAccountRecon: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[selectedPeriod: MonthYearPeriod, accountReconDataPayload: ReconciliationDataPayload[], preserveExistingTransactions?: any], {
     selectedPeriod: MonthYearPeriod;
     accountReconDataPayload: ReconciliationDataPayload[];
+    preserveExistingTransactions: any;
 }, "accountRecon/updateAccountRecon", never, never>, excludeReconReviewTransaction: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[accountReconKey: string, excludedTransactionId: string], {
     accountReconKey: string;
     excludedTransactionId: string;

package/lib/entity/accountRecon/accountReconReducer.js

@@ -14,16 +14,17 @@ const accountRecon = (0, toolkit_1.createSlice)({
     initialState: exports.initialState,
     reducers: {
         updateAccountRecon: {
-            prepare(selectedPeriod, accountReconDataPayload) {
+            prepare(selectedPeriod, accountReconDataPayload, preserveExistingTransactions = false) {
                 return {
                     payload: {
                         selectedPeriod,
                         accountReconDataPayload,
+                        preserveExistingTransactions,
                     },
                 };
             },
             reducer(draft, action) {
-                doUpdateAccountRecon(draft, action.payload.selectedPeriod, action.payload.accountReconDataPayload);
+                doUpdateAccountRecon(draft, action.payload.selectedPeriod, action.payload.accountReconDataPayload, action.payload.preserveExistingTransactions);
             },
         },
         updateAccountReconUploadStatement: {
@@ -175,7 +176,7 @@ const accountRecon = (0, toolkit_1.createSlice)({
 });
 _a = accountRecon.actions, exports.updateAccountRecon = _a.updateAccountRecon, exports.excludeReconReviewTransaction = _a.excludeReconReviewTransaction, exports.addTransactionToReconcileList = _a.addTransactionToReconcileList, exports.updateAccountReconDeleteStatement = _a.updateAccountReconDeleteStatement, exports.updateAccountReconReparseStatement = _a.updateAccountReconReparseStatement, exports.updateAccountReconUploadStatement = _a.updateAccountReconUploadStatement;
 exports.default = accountRecon.reducer;
-const doUpdateAccountRecon = (draft, selectedPeriod, accountReconDataPayload) => {
+const doUpdateAccountRecon = (draft, selectedPeriod, accountReconDataPayload, preserveExistingTransactions) => {
     accountReconDataPayload.forEach((accountReconData) => {
         const accountReconKey = (0, accountReconState_1.toAccountReconKey)(accountReconData.account_id, selectedPeriod);
         const mappedAccountRecon = (0, accountReconPayload_1.toAccountReconciliationData)(accountReconData);
@@ -185,12 +186,23 @@ const doUpdateAccountRecon = (draft, selectedPeriod, accountReconDataPayload) =>
         const shouldPreserveMatchProgress = existingAccountRecon != null &&
             accountReconData.match_progress === undefined &&
             existingAccountRecon.matchProgress != null;
-        draft.accountReconByAccountReconKey[accountReconKey] =
-            shouldPreserveMatchProgress
-                ? {
-                    ...mappedAccountRecon,
-                    matchProgress: existingAccountRecon.matchProgress,
-                }
-                : mappedAccountRecon;
+        // Full list fetch does not include transactions; keep detail-loaded
+        // reconcile/review lists so a concurrent list refresh cannot wipe them.
+        const shouldPreserveTransactions = preserveExistingTransactions === true && existingAccountRecon != null;
+        let nextAccountRecon = mappedAccountRecon;
+        if (shouldPreserveMatchProgress) {
+            nextAccountRecon = {
+                ...nextAccountRecon,
+                matchProgress: existingAccountRecon.matchProgress,
+            };
+        }
+        if (shouldPreserveTransactions) {
+            nextAccountRecon = {
+                ...nextAccountRecon,
+                transactionsToReconcile: existingAccountRecon.transactionsToReconcile,
+                transactionsToReview: existingAccountRecon.transactionsToReview,
+            };
+        }
+        draft.accountReconByAccountReconKey[accountReconKey] = nextAccountRecon;
     });
 };

package/lib/entity/accountRecon/accountReconSelector.d.ts

@@ -48,6 +48,7 @@ export interface AccountReconciliationEntity {
     };
     statementMetaData?: {
         file: File | undefined;
+        fileId?: ID;
         statementUploadId?: ID;
     };
     user?: User;

package/lib/entity/accountRecon/accountReconSelector.js

@@ -49,6 +49,7 @@ exports.getAccountReconByAccountIdAndSelectedPeriod = (0, toolkit_1.createSelect
             file: accountRecon.statementMetaData?.fileId != null
                 ? (0, fileSelector_1.getFileByFileId)(fileState, accountRecon.statementMetaData.fileId)
                 : undefined,
+            fileId: accountRecon.statementMetaData?.fileId,
             statementUploadId: accountRecon.statementMetaData?.statementUploadId,
         },
         reconUpdatedAt: accountRecon.reconUpdatedAt,

package/lib/entity/approvalRule/approvalRuleConflict.d.ts

@@ -46,6 +46,19 @@ import { ApprovalRule, Criteria } from './approvalRuleState';
 export type RuleForOverlapCheck = Pick<ApprovalRule, 'approvalRuleId' | 'criteria' | 'isFallback'>;
 export interface RuleOverlap<TRule extends RuleForOverlapCheck = ApprovalRule> {
     conflictingRule: TRule;
+    /**
+     * 'duplicate' — every criterion matches exactly, including the
+     * amount interval (same comparator + min + max, not just an
+     * intersecting range). 'partial' — vendor/department match exactly
+     * (required for any overlap at all) but the amount intervals only
+     * intersect.
+     *
+     * Callers typically treat 'duplicate' as a blocking error (the
+     * candidate rule is unreachable — the existing rule already
+     * matches every bill/reimbursement it would) and 'partial' as a
+     * dismissible warning.
+     */
+    overlapKind: 'duplicate' | 'partial';
 }
 export interface DetectRuleOverlapInput<TRule extends RuleForOverlapCheck = ApprovalRule> {
     candidateCriteria: Criteria[];

package/lib/entity/approvalRule/approvalRuleConflict.js

@@ -23,7 +23,12 @@ function detectRuleOverlap({ candidateCriteria, existingRules, excludeRuleId, })
         }
         const ruleAmount = pickAmount(rule.criteria);
         if (amountsOverlap(candidateAmount, ruleAmount)) {
-            overlaps.push({ conflictingRule: rule });
+            overlaps.push({
+                conflictingRule: rule,
+                overlapKind: areAmountCriteriaEqual(candidateAmount, ruleAmount)
+                    ? 'duplicate'
+                    : 'partial',
+            });
         }
     }
     return overlaps;
@@ -75,3 +80,13 @@ const amountsOverlap = (a, b) => {
     const bHigh = b.max?.amount ?? Number.POSITIVE_INFINITY;
     return Math.max(aLow, bLow) <= Math.min(aHigh, bHigh);
 };
+// Only called once `amountsOverlap` is already true, so this decides
+// duplicate vs partial rather than overlap vs no-overlap.
+const areAmountCriteriaEqual = (a, b) => {
+    if (a == null || b == null) {
+        return a == null && b == null;
+    }
+    return (a.comparator === b.comparator &&
+        (a.min?.amount ?? null) === (b.min?.amount ?? null) &&
+        (a.max?.amount ?? null) === (b.max?.amount ?? null));
+};

package/lib/entity/jeSchedules/jeScheduleHelper.d.ts

@@ -1,2 +1,3 @@
 import { ID } from '../../commonStateTypes/common';
 export declare function generateJEScheduleKey(jeScheduleId: ID, jeScheduleType: string): `${string}_${string}`;
+export declare function generateJEOneTimeAccrualKey(accrualId: ID): `${string}_one_time_accrual`;

package/lib/entity/jeSchedules/jeScheduleHelper.js

@@ -1,6 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.generateJEScheduleKey = generateJEScheduleKey;
+exports.generateJEOneTimeAccrualKey = generateJEOneTimeAccrualKey;
 function generateJEScheduleKey(jeScheduleId, jeScheduleType) {
     return `${jeScheduleId}_${jeScheduleType}`;
 }
+// Suffixed rather than using the bare Mongo _id so the key is a distinct type from
+// JEScheduleKey / JEScheduleTransactionKey and the three cannot be passed interchangeably.
+// The unsuffixed id stays on the entity as `accrualId` for callers that need it.
+function generateJEOneTimeAccrualKey(accrualId) {
+    return `${accrualId}_one_time_accrual`;
+}

package/lib/entity/jeSchedules/jeSchedulesPayload.d.ts

@@ -7,7 +7,7 @@ import { TransactionIDPayload } from '../transaction/payloadTypes/transactionIDP
 import { TransactionCategory } from '../transaction/stateTypes/transactionType';
 import { UserPayload } from '../user/userPayload';
 import { VendorPayload } from '../vendor/vendorPayload';
-import { JEAccruedScheduledTransactionState, JEScheduledTransactionState, ScheduledJournalEntryState } from './jeSchedulesState';
+import { JEAccruedScheduledTransactionState, JEOneTimeAccrualState, JEScheduledTransactionState, ScheduledJournalEntryState } from './jeSchedulesState';
 import { JEScheduleKey, JEScheduleTransactionKey } from './jeSchedulesTypes';
 export interface JEScheduleOtherAttributesPayload {
     asset_id?: string | null;
@@ -19,14 +19,25 @@ export interface JEScheduleAISummaryFieldPayload {
     cot?: string[];
     predicted_value?: number | string;
 }
+/** The whole-recommendation summary. Carries narrative only -- no predicted value, no confidence. */
+export interface JEScheduleSummaryPayload {
+    confidence?: number;
+    cot?: string[];
+    reasoning?: string;
+    reasoning_long?: string;
+}
 export interface JEScheduleAISummariesPayload {
     credit_account?: JEScheduleAISummaryFieldPayload;
     credit_accounting_class?: JEScheduleAISummaryFieldPayload;
     debit_account?: JEScheduleAISummaryFieldPayload;
     debit_accounting_class?: JEScheduleAISummaryFieldPayload;
+    end_date?: JEScheduleAISummaryFieldPayload;
     period?: JEScheduleAISummaryFieldPayload;
     posting_date?: JEScheduleAISummaryFieldPayload;
+    posting_start_date?: JEScheduleAISummaryFieldPayload;
+    schedule_summary?: JEScheduleSummaryPayload;
     schedule_type?: JEScheduleAISummaryFieldPayload;
+    starting_month?: JEScheduleAISummaryFieldPayload;
 }
 export interface JEScheduleRecommendationsPayload {
     credit_account_confidence?: number;
@@ -72,9 +83,13 @@ export interface JEScheduledTransactionPayload {
     updated_by: UserPayload;
     vendor: VendorPayload;
     ai_summaries?: JEScheduleAISummariesPayload;
+    confidence_score?: number | null;
+    create_time?: string | null;
     created_by?: UserPayload;
     end_date?: string | null;
+    posted_count?: number | null;
     recommendations?: JEScheduleRecommendationsPayload;
+    recurring_amount?: number | null;
     updated_at?: string | null;
 }
 export interface JEAccruedScheduledTransactionPayload extends Omit<JEScheduledTransactionPayload, 'base_transaction' | 'je_schedule_id' | 'je_schedule_type'> {
@@ -84,6 +99,67 @@ export interface JEAccruedScheduledTransactionPayload extends Omit<JEScheduledTr
     memo: string;
     recurring_amount: number;
 }
+/**
+ * The frozen vendor profile the Cron used to decide an accrual, so the detail page can show its
+ * reasoning even after the live profile is rebuilt. Present on agent/Cron rows ONLY — a human-created
+ * accrual carries none, which is why every consumer has to treat it as absent rather than empty.
+ */
+export interface JEOneTimeAccrualProfileSnapshotPayload {
+    billing_pattern?: {
+        avg_amount?: number | null;
+        billing_lag_days?: number | null;
+        consistency_score?: number | null;
+        frequency?: string | null;
+        last_bill_amount?: number | null;
+        last_bill_date?: string | null;
+        months_of_history?: number | null;
+        typical_bill_day?: number | null;
+    } | null;
+    monthly_totals?: Record<string, number> | null;
+    sorted_months?: string[] | null;
+}
+/** The JE the AI originally suggested, frozen at draft time for suggested-vs-posted comparison. */
+export interface JEOneTimeAccrualAiSuggestionPayload {
+    estimated_amount?: number | null;
+    je_credit_account_id?: ID | null;
+    je_credit_account_name?: string | null;
+    je_debit_account_id?: ID | null;
+    je_debit_account_name?: string | null;
+    memo?: string | null;
+}
+export interface JEOneTimeAccrualPayload {
+    _id: ID;
+    estimated_amount: number;
+    origin: string;
+    service_month: string;
+    status: string;
+    vendor_id: ID;
+    vendor_name: string;
+    actual_post_date?: string | null;
+    actual_reversal_post_date?: string | null;
+    ai_suggestion?: JEOneTimeAccrualAiSuggestionPayload | null;
+    automation_tier?: string | null;
+    created_by_user?: UserPayload | null;
+    currency?: string | null;
+    expected_reversal_date?: string | null;
+    is_ignored?: boolean;
+    je_credit_account_id?: ID | null;
+    je_credit_account_name?: string | null;
+    je_credit_accounting_class_id?: ID | null;
+    je_credit_accounting_class_name?: string | null;
+    je_debit_account_id?: ID | null;
+    je_debit_account_name?: string | null;
+    je_debit_accounting_class_id?: ID | null;
+    je_debit_accounting_class_name?: string | null;
+    memo?: string | null;
+    posting_date?: string | null;
+    profile_snapshot?: JEOneTimeAccrualProfileSnapshotPayload | null;
+    reversal_policy?: string | null;
+    reversal_transaction_id?: ID | null;
+    reversal_trigger?: string | null;
+    transaction_id?: ID | null;
+    transaction_integration_id?: ID | null;
+}
 export interface ScheduledJournalEntryPayload {
     actual_post_date: string | null;
     create_time: string | null;
@@ -114,3 +190,4 @@ export declare function getJEScheduleTransactionDetailKeyPayload(payload: Schedu
 export declare function getJEScheduleKey(payload: JEAccruedScheduledTransactionPayload): JEScheduleKey;
 export declare function toJEScheduledTransaction(payload: JEScheduledTransactionPayload): JEScheduledTransactionState;
 export declare function toJEAccruedScheduledTransaction(payload: JEAccruedScheduledTransactionPayload): JEAccruedScheduledTransactionState;
+export declare function toJEOneTimeAccrual(payload: JEOneTimeAccrualPayload): JEOneTimeAccrualState;

package/lib/entity/jeSchedules/jeSchedulesPayload.js

@@ -8,12 +8,15 @@ exports.getJEScheduleTransactionDetailKeyPayload = getJEScheduleTransactionDetai
 exports.getJEScheduleKey = getJEScheduleKey;
 exports.toJEScheduledTransaction = toJEScheduledTransaction;
 exports.toJEAccruedScheduledTransaction = toJEAccruedScheduledTransaction;
+exports.toJEOneTimeAccrual = toJEOneTimeAccrual;
 const amount_1 = require("../../commonStateTypes/amount");
 const timePeriod_1 = require("../../commonStateTypes/timePeriod");
 const zeniDayJS_1 = require("../../zeniDayJS");
+const zeniUrl_1 = require("../../zeniUrl");
 const transactionIDPayload_1 = require("../transaction/payloadTypes/transactionIDPayload");
 const jeScheduleHelper_1 = require("./jeScheduleHelper");
 const jeSchedulesTypes_1 = require("./jeSchedulesTypes");
+const USD_CURRENCY_CODE = 'USD';
 function toScheduledJournalEntryState(payload, currency_code, currency_symbol) {
     return {
         status: {
@@ -212,6 +215,43 @@ function toJEScheduleAISummaries(payload) {
                 : undefined,
         };
     }
+    if (payload.starting_month != null) {
+        result.startingMonth = {
+            confidence: payload.starting_month.confidence,
+            reasoning: payload.starting_month.reasoning,
+            cot: Array.isArray(payload.starting_month.cot)
+                ? payload.starting_month.cot
+                : undefined,
+        };
+    }
+    if (payload.end_date != null) {
+        result.endDate = {
+            confidence: payload.end_date.confidence,
+            reasoning: payload.end_date.reasoning,
+            cot: Array.isArray(payload.end_date.cot)
+                ? payload.end_date.cot
+                : undefined,
+        };
+    }
+    if (payload.posting_start_date != null) {
+        result.postingStartDate = {
+            confidence: payload.posting_start_date.confidence,
+            reasoning: payload.posting_start_date.reasoning,
+            cot: Array.isArray(payload.posting_start_date.cot)
+                ? payload.posting_start_date.cot
+                : undefined,
+        };
+    }
+    if (payload.schedule_summary != null) {
+        result.scheduleSummary = {
+            confidence: payload.schedule_summary.confidence,
+            reasoning: payload.schedule_summary.reasoning,
+            reasoningLong: payload.schedule_summary.reasoning_long,
+            cot: Array.isArray(payload.schedule_summary.cot)
+                ? payload.schedule_summary.cot
+                : undefined,
+        };
+    }
     return Object.keys(result).length > 0 ? result : undefined;
 }
 function toJEScheduleRecommendations(payload) {
@@ -258,9 +298,18 @@ function toJEScheduledTransaction(payload) {
         startDate: payload.start_date != null ? (0, zeniDayJS_1.date)(payload.start_date) : undefined,
         endDate: payload.end_date != null ? (0, zeniDayJS_1.date)(payload.end_date) : undefined,
         period: payload.period != null ? Number(payload.period) : undefined,
+        recurringAmount: payload.recurring_amount != null
+            ? {
+                amount: payload.recurring_amount,
+                currencyCode: payload.currency_code,
+                currencySymbol: payload.currency_symbol,
+            }
+            : undefined,
+        postedCount: payload.posted_count ?? undefined,
         updatedByUserID: payload.updated_by.user_id,
         balanceAsOfToday: payload.balance ?? undefined,
         updatedAt: payload.updated_at != null ? (0, zeniDayJS_1.date)(payload.updated_at) : undefined,
+        createTime: payload.create_time != null ? (0, zeniDayJS_1.date)(payload.create_time) : undefined,
         jeCredit: {
             accountId: payload.je_credit_account_id ?? undefined,
             accountingClassId: payload.je_credit_accounting_class_id ?? undefined,
@@ -285,6 +334,7 @@ function toJEScheduledTransaction(payload) {
             : {},
         scheduledJournalEntry: [],
         aiSummaries: toJEScheduleAISummaries(payload.ai_summaries),
+        confidenceScore: payload.confidence_score ?? undefined,
         createdByUserID: payload.created_by?.user_id ?? undefined,
         recommendations: toJEScheduleRecommendations(payload.recommendations),
     };
@@ -297,17 +347,20 @@ function toJEAccruedScheduledTransaction(payload) {
             label: payload.status.label,
         },
         vendorId: payload.vendor.vendor_id,
+        // The accrued payload extends JEScheduledTransactionPayload, so it carries currency_code and
+        // currency_symbol like every other schedule -- this mapper was hardcoding USD over fields it
+        // already had.
         recurringAmount: {
             amount: payload.recurring_amount,
-            currencyCode: 'USD',
-            currencySymbol: '$',
+            currencyCode: payload.currency_code,
+            currencySymbol: payload.currency_symbol,
         },
         otherAttributes: {
             startingBalance: payload.other_attributes?.starting_balance != null
                 ? {
                     amount: payload.other_attributes?.starting_balance ?? 0,
-                    currencyCode: 'USD',
-                    currencySymbol: '$',
+                    currencyCode: payload.currency_code,
+                    currencySymbol: payload.currency_symbol,
                 }
                 : undefined,
         },
@@ -316,6 +369,9 @@ function toJEAccruedScheduledTransaction(payload) {
         endDate: payload.end_date != null ? (0, zeniDayJS_1.date)(payload.end_date) : undefined,
         period: payload.period != null ? Number(payload.period) : undefined,
         updatedByUserID: payload.updated_by.user_id,
+        // The accrued joiner resolves createdByUserID into the "Created by" cell. Without this the
+        // payload's created_by was dropped here and every accrued row rendered a hyphen.
+        createdByUserID: payload.created_by?.user_id ?? undefined,
         balanceAsOfToday: payload.balance ?? undefined,
         updatedAt: payload.updated_at != null ? (0, zeniDayJS_1.date)(payload.updated_at) : undefined,
         jeCredit: {
@@ -342,3 +398,126 @@ function toJEAccruedScheduledTransaction(payload) {
         jeScheduleType: (0, jeSchedulesTypes_1.toScheduleTypesTypeStrict)(payload.je_schedule_type),
     };
 }
+/**
+ * Reads the months in the order the snapshot gives them rather than deriving a range: a vendor that
+ * skipped a month has no entry for it, so filling gaps would invent history that was never billed.
+ */
+function toJEOneTimeAccrualMonthlyTotals(snapshot, currencyCode) {
+    const monthlyTotals = snapshot.monthly_totals;
+    if (monthlyTotals == null) {
+        return [];
+    }
+    const months = snapshot.sorted_months ?? Object.keys(monthlyTotals).sort();
+    return months
+        .filter((month) => monthlyTotals[month] != null)
+        .map((month) => ({
+        month,
+        amount: toOneTimeAccrualAmount(monthlyTotals[month], currencyCode),
+    }));
+}
+function toJEOneTimeAccrualProfileSnapshot(payload, currencyCode) {
+    if (payload == null) {
+        return undefined;
+    }
+    const billingPattern = payload.billing_pattern;
+    return {
+        monthlyTotals: toJEOneTimeAccrualMonthlyTotals(payload, currencyCode),
+        billingPattern: billingPattern != null
+            ? {
+                frequency: billingPattern.frequency ?? undefined,
+                monthsOfHistory: billingPattern.months_of_history ?? undefined,
+                consistencyScore: billingPattern.consistency_score ?? undefined,
+                billingLagDays: billingPattern.billing_lag_days ?? undefined,
+                typicalBillDay: billingPattern.typical_bill_day ?? undefined,
+                avgAmount: billingPattern.avg_amount != null
+                    ? toOneTimeAccrualAmount(billingPattern.avg_amount, currencyCode)
+                    : undefined,
+                lastBillAmount: billingPattern.last_bill_amount != null
+                    ? toOneTimeAccrualAmount(billingPattern.last_bill_amount, currencyCode)
+                    : undefined,
+                lastBillDate: billingPattern.last_bill_date != null
+                    ? (0, zeniDayJS_1.date)(billingPattern.last_bill_date)
+                    : undefined,
+            }
+            : undefined,
+    };
+}
+function toJEOneTimeAccrualAiSuggestion(payload, currencyCode) {
+    if (payload == null) {
+        return undefined;
+    }
+    return {
+        memo: payload.memo ?? undefined,
+        jeDebitAccountName: payload.je_debit_account_name ?? undefined,
+        jeCreditAccountName: payload.je_credit_account_name ?? undefined,
+        estimatedAmount: payload.estimated_amount != null
+            ? toOneTimeAccrualAmount(payload.estimated_amount, currencyCode)
+            : undefined,
+    };
+}
+function toJEOneTimeAccrual(payload) {
+    return {
+        accrualId: payload._id,
+        vendorId: payload.vendor_id,
+        vendorName: payload.vendor_name,
+        serviceMonth: payload.service_month,
+        accrualStatus: (0, jeSchedulesTypes_1.toOneTimeAccrualStatusCodeType)(payload.status),
+        origin: (0, jeSchedulesTypes_1.toOneTimeAccrualOriginType)(payload.origin),
+        automationTier: payload.automation_tier != null
+            ? (0, jeSchedulesTypes_1.toOneTimeAccrualAutomationTierType)(payload.automation_tier)
+            : undefined,
+        estimatedAmount: toOneTimeAccrualAmount(payload.estimated_amount, payload.currency),
+        memo: payload.memo ?? '',
+        profileSnapshot: toJEOneTimeAccrualProfileSnapshot(payload.profile_snapshot, payload.currency),
+        isIgnored: payload.is_ignored === true,
+        aiSuggestion: toJEOneTimeAccrualAiSuggestion(payload.ai_suggestion, payload.currency),
+        // Exclusive by contract: a scheduled row reverses on expectedReversalDate and bills never
+        // drive it, so the two never need reconciling. Defaulting to on_bill_match matches the
+        // create path's default when the field is absent on an older document.
+        reversalPolicy: (0, jeSchedulesTypes_1.toOneTimeAccrualReversalPolicyType)(payload.reversal_policy ?? 'on_bill_match'),
+        reversalTrigger: (0, jeSchedulesTypes_1.toOneTimeAccrualReversalTriggerType)(payload.reversal_trigger ?? undefined),
+        expectedReversalDate: payload.expected_reversal_date != null
+            ? (0, zeniDayJS_1.date)(payload.expected_reversal_date)
+            : undefined,
+        postingDate: payload.posting_date != null ? (0, zeniDayJS_1.date)(payload.posting_date) : undefined,
+        actualPostDate: payload.actual_post_date != null
+            ? (0, zeniDayJS_1.date)(payload.actual_post_date)
+            : undefined,
+        actualReversalPostDate: payload.actual_reversal_post_date != null
+            ? (0, zeniDayJS_1.date)(payload.actual_reversal_post_date)
+            : undefined,
+        jeDebitAccountId: payload.je_debit_account_id ?? undefined,
+        jeDebitAccountName: payload.je_debit_account_name ?? undefined,
+        jeDebitAccountingClassId: payload.je_debit_accounting_class_id ?? undefined,
+        jeDebitAccountingClassName: payload.je_debit_accounting_class_name ?? undefined,
+        jeCreditAccountId: payload.je_credit_account_id ?? undefined,
+        jeCreditAccountName: payload.je_credit_account_name ?? undefined,
+        jeCreditAccountingClassId: payload.je_credit_accounting_class_id ?? undefined,
+        jeCreditAccountingClassName: payload.je_credit_accounting_class_name ?? undefined,
+        transactionId: payload.transaction_id ?? undefined,
+        transactionIntegrationId: payload.transaction_integration_id ?? undefined,
+        reversalTransactionId: payload.reversal_transaction_id ?? undefined,
+        createdBy: toJEOneTimeAccrualCreator(payload.created_by_user),
+    };
+}
+// The accrual wire format carries a currency CODE but no symbol, so the symbol has to be derived.
+// Only USD has a known glyph today (the create path is USD-only); anything else falls back to the
+// code, which reads correctly as "EUR 1,200" rather than silently rendering a wrong "$".
+function toOneTimeAccrualAmount(amount, currencyCode) {
+    const code = currencyCode ?? USD_CURRENCY_CODE;
+    return (0, amount_1.toAmount)(amount, code, code === USD_CURRENCY_CODE ? '$' : code);
+}
+function toJEOneTimeAccrualCreator(payload) {
+    if (payload == null) {
+        return undefined;
+    }
+    return {
+        userId: payload.user_id,
+        email: payload.email ?? undefined,
+        firstName: payload.first_name ?? undefined,
+        lastName: payload.last_name ?? undefined,
+        photo: payload.photo?.original != null
+            ? (0, zeniUrl_1.toZeniUrl)(payload.photo.original)
+            : undefined,
+    };
+}

package/lib/entity/jeSchedules/jeSchedulesReducer.d.ts

@@ -1,5 +1,5 @@
 import { UpdateType } from '../../commonStateTypes/common';
-import { JEAccruedScheduledTransactionPayload, JEScheduledTransactionPayload, ScheduledJournalEntryPayload } from './jeSchedulesPayload';
+import { JEAccruedScheduledTransactionPayload, JEOneTimeAccrualPayload, JEScheduledTransactionPayload, ScheduledJournalEntryPayload } from './jeSchedulesPayload';
 import { JESchedulesState } from './jeSchedulesState';
 export declare const initialState: JESchedulesState;
 export declare const updateJESchedules: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[jeSchedulesTransactionsPayload: JEScheduledTransactionPayload[]], {
@@ -22,6 +22,8 @@ export declare const updateJESchedules: import("@reduxjs/toolkit").ActionCreator
     jeScheduleTransactionKey: `${string}_expense_${string}` | `${string}_check_${string}` | `${string}_invoice_${string}` | `${string}_payment_${string}` | `${string}_credit_memo_${string}` | `${string}_sales_receipt_${string}` | `${string}_delayed_credit_${string}` | `${string}_delayed_charge_${string}` | `${string}_refund_${string}` | `${string}_bill_${string}` | `${string}_bill_payment_${string}` | `${string}_bill_payment_check_${string}` | `${string}_bill_payment_credit_card_${string}` | `${string}_vendor_credit_${string}` | `${string}_credit_card_credit_${string}` | `${string}_transfer_${string}` | `${string}_credit_card_payment_${string}` | `${string}_deposit_${string}` | `${string}_journal_entry_${string}`;
 }, "jeSchedules/deleteJESchedulesDetails", never, never>, deleteAccruedJESchedulesDetails: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[JEScheduleKey: `${string}_${string}`], {
     JEScheduleKey: `${string}_${string}`;
-}, "jeSchedules/deleteAccruedJESchedulesDetails", never, never>;
+}, "jeSchedules/deleteAccruedJESchedulesDetails", never, never>, clearAllAccruedJESchedules: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"jeSchedules/clearAllAccruedJESchedules">, clearAllJEScheduleTransactions: import("@reduxjs/toolkit").ActionCreatorWithoutPayload<"jeSchedules/clearAllJEScheduleTransactions">, updateJEOneTimeAccruals: import("@reduxjs/toolkit").ActionCreatorWithPreparedPayload<[jeOneTimeAccrualsPayload: JEOneTimeAccrualPayload[]], {
+    jeOneTimeAccrualsPayload: JEOneTimeAccrualPayload[];
+}, "jeSchedules/updateJEOneTimeAccruals", never, never>;
 declare const _default: import("redux").Reducer<JESchedulesState>;
 export default _default;

package/lib/entity/jeSchedules/jeSchedulesReducer.js

@@ -4,14 +4,16 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 var _a;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deleteAccruedJESchedulesDetails = exports.deleteJESchedulesDetails = exports.updateAccruedJESchedulesDetails = exports.updateJESchedulesDetails = exports.updateAccruedJEScheduledTransaction = exports.updateJEScheduledTransaction = exports.updateAccruedJESchedules = exports.updateJESchedules = exports.initialState = void 0;
+exports.updateJEOneTimeAccruals = exports.clearAllJEScheduleTransactions = exports.clearAllAccruedJESchedules = exports.deleteAccruedJESchedulesDetails = exports.deleteJESchedulesDetails = exports.updateAccruedJESchedulesDetails = exports.updateJESchedulesDetails = exports.updateAccruedJEScheduledTransaction = exports.updateJEScheduledTransaction = exports.updateAccruedJESchedules = exports.updateJESchedules = exports.initialState = void 0;
 const toolkit_1 = require("@reduxjs/toolkit");
 const assignWith_1 = __importDefault(require("lodash/assignWith"));
 const rootActions_1 = require("../../rootActions");
+const jeScheduleHelper_1 = require("./jeScheduleHelper");
 const jeSchedulesPayload_1 = require("./jeSchedulesPayload");
 exports.initialState = {
     schedulesByTransactionKey: {},
     schedulesByAccruedJEScheduleKey: {},
+    oneTimeAccrualsByKey: {},
 };
 const jeSchedules = (0, toolkit_1.createSlice)({
     name: 'jeSchedules',
@@ -116,15 +118,41 @@ const jeSchedules = (0, toolkit_1.createSlice)({
                 delete draft.schedulesByAccruedJEScheduleKey[JEScheduleKey];
             },
         },
+        // Writes directly, unlike updateAccruedJESchedules / updateJESchedules, which are no-op
+        // actions whose only job is to trigger the entity fan-out epic that fetches vendors,
+        // accounts, classes and users. An accrual denormalizes all of those as names on the document,
+        // so there is nothing to fan out to.
+        updateJEOneTimeAccruals: {
+            prepare(jeOneTimeAccrualsPayload) {
+                return {
+                    payload: {
+                        jeOneTimeAccrualsPayload,
+                    },
+                };
+            },
+            reducer(draft, action) {
+                action.payload.jeOneTimeAccrualsPayload.forEach((accrualPayload) => {
+                    const accrual = (0, jeSchedulesPayload_1.toJEOneTimeAccrual)(accrualPayload);
+                    draft.oneTimeAccrualsByKey[(0, jeScheduleHelper_1.generateJEOneTimeAccrualKey)(accrual.accrualId)] = accrual;
+                });
+            },
+        },
+        clearAllJEScheduleTransactions(draft) {
+            draft.schedulesByTransactionKey = {};
+        },
+        clearAllAccruedJESchedules(draft) {
+            draft.schedulesByAccruedJEScheduleKey = {};
+        },
     },
     extraReducers: (builder) => {
         builder.addCase(rootActions_1.clearAll, (draft) => {
             draft.schedulesByAccruedJEScheduleKey = {};
             draft.schedulesByTransactionKey = {};
+            draft.oneTimeAccrualsByKey = {};
         });
     },
 });
-_a = jeSchedules.actions, exports.updateJESchedules = _a.updateJESchedules, exports.updateAccruedJESchedules = _a.updateAccruedJESchedules, exports.updateJEScheduledTransaction = _a.updateJEScheduledTransaction, exports.updateAccruedJEScheduledTransaction = _a.updateAccruedJEScheduledTransaction, exports.updateJESchedulesDetails = _a.updateJESchedulesDetails, exports.updateAccruedJESchedulesDetails = _a.updateAccruedJESchedulesDetails, exports.deleteJESchedulesDetails = _a.deleteJESchedulesDetails, exports.deleteAccruedJESchedulesDetails = _a.deleteAccruedJESchedulesDetails;
+_a = jeSchedules.actions, exports.updateJESchedules = _a.updateJESchedules, exports.updateAccruedJESchedules = _a.updateAccruedJESchedules, exports.updateJEScheduledTransaction = _a.updateJEScheduledTransaction, exports.updateAccruedJEScheduledTransaction = _a.updateAccruedJEScheduledTransaction, exports.updateJESchedulesDetails = _a.updateJESchedulesDetails, exports.updateAccruedJESchedulesDetails = _a.updateAccruedJESchedulesDetails, exports.deleteJESchedulesDetails = _a.deleteJESchedulesDetails, exports.deleteAccruedJESchedulesDetails = _a.deleteAccruedJESchedulesDetails, exports.clearAllAccruedJESchedules = _a.clearAllAccruedJESchedules, exports.clearAllJEScheduleTransactions = _a.clearAllJEScheduleTransactions, exports.updateJEOneTimeAccruals = _a.updateJEOneTimeAccruals;
 exports.default = jeSchedules.reducer;
 /**
  * Helper functions

package/lib/entity/jeSchedules/jeSchedulesSelector.d.ts

@@ -9,8 +9,8 @@ import { ScheduleTransaction } from '../transaction/stateTypes/scheduleTransacti
 import { TransactionID } from '../transaction/stateTypes/transactionID';
 import { User } from '../user/userState';
 import { Vendor } from '../vendor/vendorState';
-import { JEScheduleAISummaries, JEScheduleOtherAttributes, JEScheduleRecommendations, ScheduleJournalStatusCode, ScheduleStatus } from './jeSchedulesState';
-import { JEScheduleKey, JEScheduleTransactionKey, JournalEntryErrorCodeType, ScheduleTypes } from './jeSchedulesTypes';
+import { JEOneTimeAccrualState, JEScheduleAISummaries, JEScheduleOtherAttributes, JEScheduleRecommendations, JESchedulesState, ScheduleJournalStatusCode, ScheduleStatus } from './jeSchedulesState';
+import { JEOneTimeAccrualKey, JEScheduleKey, JEScheduleTransactionKey, JournalEntryErrorCodeType, ScheduleTypes } from './jeSchedulesTypes';
 export interface ScheduledJournalEntry {
     error: JournalEntryErrorCodeType[];
     expectedPostDate: ZeniDate;
@@ -55,13 +55,17 @@ export interface JEScheduledTransaction {
         accountingClass?: Class;
     };
     jeScheduleTransactionKey: JEScheduleTransactionKey;
+    lifecycleTotal: number;
     otherAttributes: JEScheduleOtherAttributes;
+    postedCount: number;
     scheduledJournalEntry: ScheduledJournalEntry[];
     status: ScheduleStatus;
     vendor: Vendor;
     aiSummaries?: JEScheduleAISummaries;
     balanceAsOfToday?: Amount;
+    confidenceScore?: number;
     createdByUser?: User;
+    createTime?: ZeniDate;
     dayOfPostingDate?: ScheduleDaysOfMonth;
     endDate?: ZeniDate;
     jeScheduleId?: ID;
@@ -69,9 +73,14 @@ export interface JEScheduledTransaction {
     lastDayOfMonth?: boolean;
     period?: number;
     recommendations?: JEScheduleRecommendations;
+    recurringAmount?: Amount;
     startDate?: ZeniDate;
     updatedAt?: ZeniDate;
     updatedByUser?: User;
 }
+export interface JEOneTimeAccrual extends JEOneTimeAccrualState {
+    jeOneTimeAccrualKey: JEOneTimeAccrualKey;
+}
+export declare const getJEOneTimeAccrualByKey: (jeOneTimeAccrualKey: JEOneTimeAccrualKey, jeSchedulesState: JESchedulesState) => JEOneTimeAccrual | undefined;
 export declare const getJEAccruedScheduleByJEScheduleKey: (JEScheduleKey: JEScheduleKey, state: RootState) => JEAccruedSchedule | undefined;
 export declare const getJEScheduledTransactionByJEScheduleTransactionKey: (jeScheduleTransactionKey: JEScheduleTransactionKey, state: RootState) => JEScheduledTransaction;