@zeniai/client-epic-state 5.0.77 → 5.0.78

package/lib/view/expenseAutomationView/transactionFilterHelpers.js

@@ -1,262 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.applyTransactionFilters = exports.TRANSACTION_FILTER_CATEGORIES = void 0;
-/**
- * Narrowing type-guard for "has a non-empty string here". Used in place of
- * raw `if (foo)` truthiness checks on `string | null | undefined` values so
- * the `@typescript-eslint/strict-boolean-expressions` lint stays clean —
- * empty strings should explicitly fall through to the next candidate
- * (vendorName → customerName → localData.vendor.name → ...) rather than
- * being implicitly coerced to falsy.
- */
-const isNonEmptyString = (s) => s != null && s !== '';
-/**
- * First line item in UI order. `lineItemById` is a Record whose iteration
- * order is not guaranteed to match what the user sees; `sortedLineItems`
- * is the canonical ordering used by the categorization list/detail views.
- */
-const getFirstLineItemFromReviewLocalData = (localData) => {
-    const { sortedLineItems, lineItemById } = localData;
-    if (sortedLineItems.length > 0) {
-        return lineItemById[sortedLineItems[0]];
-    }
-    const lineItems = Object.values(lineItemById);
-    return lineItems.length > 0 ? lineItems[0] : undefined;
-};
-exports.TRANSACTION_FILTER_CATEGORIES = [
-    { value: 'payment_account_name', type: 'dropdown' },
-    { value: 'payment_account_type', type: 'dropdown' },
-    { value: 'payee', type: 'searchAutocomplete' },
-    { value: 'category', type: 'dropdown' },
-    { value: 'class', type: 'dropdown' },
-    { value: 'amount', type: 'numberRange' },
-];
-/**
- * Resolve the comparable value for a transaction against a given filter field.
- * Returns undefined when the transaction doesn't carry the field — callers
- * decide whether absence counts as a match (for 'not_equal' it does).
- */
-const getCategoryValueForTransaction = (key, transaction) => {
-    switch (key) {
-        case 'amount': {
-            // Prefer transactionLocalData line items (sum). Fall back to lines on
-            // the transaction itself. Final fallback: transaction-level amount.
-            const localDataForAmount = transaction.transactionLocalData?.transactionReviewLocalData;
-            if (localDataForAmount?.lineItemById) {
-                const lineItems = Object.values(localDataForAmount.lineItemById);
-                if (lineItems.length > 0) {
-                    return lineItems.reduce((sum, lineItem) => sum + (lineItem.amount?.amount ?? 0), 0);
-                }
-            }
-            if (transaction.transaction.lines &&
-                transaction.transaction.lines.length > 0) {
-                return transaction.transaction.lines.reduce((sum, line) => sum + (line.amount?.amount ?? 0), 0);
-            }
-            return transaction.amount.amount;
-        }
-        case 'payee': {
-            if (isNonEmptyString(transaction.vendorName)) {
-                return transaction.vendorName;
-            }
-            if (isNonEmptyString(transaction.customerName)) {
-                return transaction.customerName;
-            }
-            const localData = transaction.transactionLocalData?.transactionReviewLocalData;
-            const vendorName = localData?.vendor?.name;
-            if (isNonEmptyString(vendorName)) {
-                return vendorName;
-            }
-            const customerName = localData?.customer?.name;
-            if (isNonEmptyString(customerName)) {
-                return customerName;
-            }
-            return undefined;
-        }
-        case 'payment_account_name': {
-            // Match what TransactionCategorizationListRow renders for the cell.
-            return transaction.transaction.account?.accountName;
-        }
-        case 'payment_account_type': {
-            // Raw `paymentType` enum ("credit_card" / "check" / "cash"). Dropdown
-            // option values use the same enum; row uses `paymentTypeName` for the
-            // human label.
-            return transaction.transaction.paymentType;
-        }
-        case 'category': {
-            const localDataForCategory = transaction.transactionLocalData?.transactionReviewLocalData;
-            if (localDataForCategory != null) {
-                const firstLineItem = getFirstLineItemFromReviewLocalData(localDataForCategory);
-                const accountId = firstLineItem?.account?.accountId;
-                if (isNonEmptyString(accountId)) {
-                    return accountId;
-                }
-                const qboId = firstLineItem?.account?.qboId;
-                if (isNonEmptyString(qboId)) {
-                    return qboId;
-                }
-                const accountName = firstLineItem?.account?.accountName;
-                if (isNonEmptyString(accountName)) {
-                    return accountName;
-                }
-            }
-            const firstLineForCategory = transaction.transaction.lines?.[0];
-            if (firstLineForCategory?.type ===
-                'transaction_with_account_and_class_line' ||
-                firstLineForCategory?.type ===
-                    'transaction_with_product_or_service_line' ||
-                firstLineForCategory?.type === 'journal_entry_transaction_line') {
-                const account = firstLineForCategory.account;
-                return account?.accountId ?? account?.qboId ?? account?.accountName;
-            }
-            return undefined;
-        }
-        case 'class': {
-            const localDataForClass = transaction.transactionLocalData?.transactionReviewLocalData;
-            if (localDataForClass != null) {
-                const firstLineItemForClass = getFirstLineItemFromReviewLocalData(localDataForClass);
-                const classId = firstLineItemForClass?.class?.classId;
-                if (isNonEmptyString(classId)) {
-                    return classId;
-                }
-                const qboId = firstLineItemForClass?.class?.qboId;
-                if (isNonEmptyString(qboId)) {
-                    return qboId;
-                }
-                const className = firstLineItemForClass?.class?.className;
-                if (isNonEmptyString(className)) {
-                    return className;
-                }
-            }
-            const firstLineForClass = transaction.transaction.lines?.[0];
-            if (firstLineForClass?.type === 'transaction_with_account_and_class_line' ||
-                firstLineForClass?.type ===
-                    'transaction_with_product_or_service_line' ||
-                firstLineForClass?.type === 'journal_entry_transaction_line') {
-                const classData = firstLineForClass.class;
-                return classData?.classId ?? classData?.qboId ?? classData?.className;
-            }
-            return undefined;
-        }
-        default:
-            return undefined;
-    }
-};
-/**
- * TC-only amount matcher. Supports all five operators TC defines, including
- * the legacy "1000<->5000" range-string form (kept for backward compatibility
- * with persisted filter state that may still contain that encoding).
- *
- * The `'equal' | 'not_equal'` branch matches if `amount` equals ANY of the
- * configured values (consistent with how non-amount filters interpret a
- * multi-value `values` array). `.some()` over the values array also makes
- * the empty-values case behave correctly — empty array → `matched = false`
- * — though in practice `applyTransactionFilters` strips empty-values
- * categories before they reach this matcher. The trailing
- * `op === 'not_equal' ? !matched : matched` line inverts for `not_equal`.
- */
-const matchAmount = (amount, category) => {
-    const op = category.matchingOperator;
-    const values = category.values;
-    let matched = false;
-    if (op === 'in_between') {
-        if (values.length >= 2) {
-            const min = Number(values[0]);
-            const max = Number(values[1]);
-            matched = amount >= min && amount <= max;
-        }
-    }
-    else if (op === 'less_than') {
-        if (values.length >= 1) {
-            matched = amount < Number(values[0]);
-        }
-    }
-    else if (op === 'greater_than') {
-        if (values.length >= 1) {
-            matched = amount > Number(values[0]);
-        }
-    }
-    else if (op === 'equal' || op === 'not_equal') {
-        matched = values.some((v) => {
-            const s = String(v);
-            // Backward compatibility: legacy "low<->high" range-string form
-            // persisted under `matchingOperator: 'equal'`.
-            if (s.includes('<->')) {
-                const parts = s.split('<->');
-                return (amount >= Number(parts[0] ?? '') && amount <= Number(parts[1] ?? ''));
-            }
-            return amount === Number(v);
-        });
-    }
-    return op === 'not_equal' ? !matched : matched;
-};
-const transactionMatchesCategory = (transaction, category) => {
-    const value = getCategoryValueForTransaction(category.field, transaction);
-    if (value == null) {
-        // Absent-value semantics — pinning these down explicitly so the
-        // asymmetry isn't surprising:
-        //
-        //   not_equal: a missing value IS NOT EQUAL to any candidate, so the
-        //              transaction matches the filter (passes through).
-        //   equal:     a missing value is not equal to any candidate, so the
-        //              transaction does NOT match (filtered out).
-        //   less_than / greater_than: SQL-style three-valued logic — comparing
-        //              against a missing value is "unknown", which we treat as
-        //              "does not match" (filtered out). A user setting
-        //              "amount < $1000" probably wants transactions with a
-        //              concrete amount that satisfies the bound, not rows
-        //              where the amount can't be determined.
-        //   in_between: same as the single-sided comparators — missing values
-        //              are filtered out.
-        //
-        // Only the `not_equal` branch returns `true` here; everything else
-        // falls through to the `false` below.
-        return category.matchingOperator === 'not_equal';
-    }
-    if (category.field === 'amount') {
-        return matchAmount(Number(value), category);
-    }
-    const valueStr = value.toString();
-    const valueInList = category.values.some((v) => v.toString() === valueStr);
-    return category.matchingOperator === 'not_equal' ? !valueInList : valueInList;
-};
-/**
- * TC-only equivalent of `applyAdvancedFiltersOnList`. Filters a list of
- * `TransactionView` items against a `TransactionFilters` object using the
- * AND/OR combination semantics from `categoryCombinationOperator`.
- *
- * Independent of `view/spendManagement` — keeps the TC filter pipeline cleanly
- * inside the Expense Automation feature group.
- */
-const applyTransactionFilters = (transactions, filters) => {
-    if (filters?.categories == null || filters.categories.length === 0) {
-        return transactions;
-    }
-    // Mirrors the predicate used by `getTransactionAppliedFiltersCount` on the
-    // webc side. A half-filled category — e.g. `in_between` with only the
-    // `min` typed — would otherwise survive the filter pass and produce zero
-    // matches because `Number("")` collapses to `0`, artificially emptying
-    // the list while editing. Skipping such categories keeps the filtered
-    // view stable while the user finishes typing.
-    const activeCategories = filters.categories.filter((c) => {
-        if (c.field == null || c.values.length === 0) {
-            return false;
-        }
-        if (c.field === 'amount' && c.matchingOperator === 'in_between') {
-            return (c.values.length >= 2 &&
-                String(c.values[0] ?? '').trim() !== '' &&
-                String(c.values[1] ?? '').trim() !== '');
-        }
-        return String(c.values[0] ?? '').trim() !== '';
-    });
-    if (activeCategories.length === 0) {
-        return transactions;
-    }
-    const op = filters.categoryCombinationOperator;
-    return transactions.filter((txn) => {
-        if (op === 'AND') {
-            return activeCategories.every((cat) => transactionMatchesCategory(txn, cat));
-        }
-        return activeCategories.some((cat) => transactionMatchesCategory(txn, cat));
-    });
-};
-exports.applyTransactionFilters = applyTransactionFilters;

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

@@ -1,10 +0,0 @@
-export declare const toCompletedSubTab: (v: string) => "all" | "manual" | "ai_accountant";
-export type CompletedSubTab = ReturnType<typeof toCompletedSubTab>;
-/**
- * "No sub-tab filter" sentinel — single source of truth for the default
- * value of {@link CompletedSubTab}. Use this constant in initial slice
- * state and at any call site that needs to fall back to the parent-tab
- * listing semantics (review tab requests, manual-search overrides, etc.)
- * so a future rename of the union doesn't require chasing literals.
- */
-export declare const DEFAULT_COMPLETED_SUB_TAB: CompletedSubTab;

package/lib/view/expenseAutomationView/types/completedSubTab.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_COMPLETED_SUB_TAB = exports.toCompletedSubTab = void 0;
-const stringToUnion_1 = require("../../../commonStateTypes/stringToUnion");
-/**
- * Sub-tabs that can appear under any "Completed" tab in the Expense Automation
- * surface (Transaction Categorization Completed and Missing Receipts Completed
- * both use this exact union). Forwarded verbatim to listing APIs as `sub_tab`
- * / `match_type`. `'all'` preserves parent-tab semantics on the backend.
- */
-const COMPLETED_SUB_TABS = ['all', 'ai_accountant', 'manual'];
-const toCompletedSubTab = (v) => (0, stringToUnion_1.stringToUnion)(v.trim().toLowerCase(), COMPLETED_SUB_TABS);
-exports.toCompletedSubTab = toCompletedSubTab;
-/**
- * "No sub-tab filter" sentinel — single source of truth for the default
- * value of {@link CompletedSubTab}. Use this constant in initial slice
- * state and at any call site that needs to fall back to the parent-tab
- * listing semantics (review tab requests, manual-search overrides, etc.)
- * so a future rename of the union doesn't require chasing literals.
- */
-exports.DEFAULT_COMPLETED_SUB_TAB = 'all';

package/lib/view/recommendation/fetchEntityRecommendationsForLineUpdateEpic.d.ts

@@ -1,9 +0,0 @@
-import { ActionsObservable, StateObservable } from 'redux-observable';
-import { Observable } from 'rxjs';
-import { RootState } from '../../reducer';
-import { ZeniAPI } from '../../zeniAPI';
-import { markCategoryClassRecommendationsCompletedForCategorization, markCategoryClassRecommendationsFailureForCategorization, markCategoryClassRecommendationsInProgressForCategorization, setEntityRecommendationForLineIdsForCategorization } from '../expenseAutomationView/reducers/transactionsViewReducer';
-import { markCategoryClassRecommendationsCompletedForTransactionDetail, markCategoryClassRecommendationsFailureForTransactionDetail, markCategoryClassRecommendationsInProgressForTransactionDetail, setEntityRecommendationForLineIdsForTransactionDetail } from '../transactionDetail/transactionDetailReducer';
-import { fetchEntityRecommendationsForLineUpdate } from './recommendationReducer';
-export type ActionType = ReturnType<typeof fetchEntityRecommendationsForLineUpdate> | ReturnType<typeof markCategoryClassRecommendationsInProgressForCategorization> | ReturnType<typeof markCategoryClassRecommendationsCompletedForCategorization> | ReturnType<typeof markCategoryClassRecommendationsFailureForCategorization> | ReturnType<typeof markCategoryClassRecommendationsInProgressForTransactionDetail> | ReturnType<typeof markCategoryClassRecommendationsCompletedForTransactionDetail> | ReturnType<typeof markCategoryClassRecommendationsFailureForTransactionDetail> | ReturnType<typeof setEntityRecommendationForLineIdsForCategorization> | ReturnType<typeof setEntityRecommendationForLineIdsForTransactionDetail>;
-export declare const fetchEntityRecommendationsForLineUpdateEpic: (actions$: ActionsObservable<ActionType>, state$: StateObservable<RootState>, zeniAPI: ZeniAPI) => Observable<ActionType>;

package/lib/view/recommendation/fetchEntityRecommendationsForLineUpdateEpic.js

@@ -1,91 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.fetchEntityRecommendationsForLineUpdateEpic = void 0;
-const rxjs_1 = require("rxjs");
-const operators_1 = require("rxjs/operators");
-const tenantSelector_1 = require("../../entity/tenant/tenantSelector");
-const transactionHelper_1 = require("../../entity/transaction/transactionHelper");
-const responsePayload_1 = require("../../responsePayload");
-const accountListSelector_1 = require("../accountList/accountListSelector");
-const transactionsViewReducer_1 = require("../expenseAutomationView/reducers/transactionsViewReducer");
-const transactionDetailReducer_1 = require("../transactionDetail/transactionDetailReducer");
-const recommendationHelper_1 = require("./recommendationHelper");
-const recommendationReducer_1 = require("./recommendationReducer");
-// Close the per-target groupBy bucket after this much idle time so inactive
-// groups don't accumulate forever (each group holds a Subject + a chain of
-// active subscribers; without a duration selector groupBy retains them for
-// the lifetime of the source observable, which is the lifetime of the app).
-// Picked at 60s to leave a generous window for re-fetches on the same
-// payee/transaction/line target while still bounding memory.
-const GROUP_INACTIVITY_TIMEOUT_MS = 60000;
-// Build the groupBy key. Same flow + same transaction + same line set
-// share a target so switchMap can cancel an in-flight prior fetch. Use
-// NUL (\u0000) as separator because it can never appear in transaction
-// or line ids (vs the `|` used in an earlier WIP which collides with
-// pipe-delimited synthetic ids).
-const SEPARATOR = '\u0000';
-const toGroupKey = (flowType, transactionId, lineIds) => `${flowType}${SEPARATOR}${transactionId}${SEPARATOR}${[...lineIds]
-    .sort((a, b) => a.localeCompare(b))
-    .join(SEPARATOR)}`;
-// Targeted recommendations fetch that drives the per-line skeleton, the
-// list-page row-checkbox uncheck/recheck, and the page-level Save
-// disable.
-//
-// Concurrency model:
-//   - groupBy by (flowType, transactionId, sorted lineIds) so distinct
-//     targets run in parallel.
-//   - inside each group, switchMap so a re-fetch on the SAME target
-//     cancels any prior in-flight request for that target.
-//   - groupBy duration selector closes idle groups to bound memory.
-const fetchEntityRecommendationsForLineUpdateEpic = (actions$, state$, zeniAPI) => actions$.pipe((0, operators_1.filter)(recommendationReducer_1.fetchEntityRecommendationsForLineUpdate.match), (0, operators_1.groupBy)((action) => toGroupKey(action.payload.flowType, action.payload.transactionDetails.transactionId.id, action.payload.transactionDetails.lineIds), undefined, (group$) => group$.pipe((0, operators_1.debounce)(() => (0, rxjs_1.timer)(GROUP_INACTIVITY_TIMEOUT_MS)))), (0, operators_1.mergeMap)((group$) => group$.pipe((0, operators_1.switchMap)((action) => {
-    const payload = action.payload;
-    const { transactionId, transaction, lineIds } = payload.transactionDetails;
-    const { entity, amount, isFetchCOT, isUncategorizedExpenseCategoryEnabled, } = payload;
-    // Synchronously emit the start arm so the per-line skeleton +
-    // row uncheck happen before the HTTP request begins. The
-    // discriminated-union payload narrows `payload.selectedTab` to
-    // a non-optional `TransactionsTab` inside the `'categorization'`
-    // branch, so no defensive fallthrough is needed.
-    const startAction = payload.flowType === 'categorization'
-        ? (0, transactionsViewReducer_1.markCategoryClassRecommendationsInProgressForCategorization)(payload.selectedTab, transactionId, lineIds)
-        : (0, transactionDetailReducer_1.markCategoryClassRecommendationsInProgressForTransactionDetail)(transactionId, lineIds);
-    const url = (0, recommendationHelper_1.buildRecommendationUrl)(zeniAPI.apiEndPoints.accountMicroServiceBaseUrl, entity, amount, payload.transactionDetails, isFetchCOT === true);
-    const httpStream$ = zeniAPI
-        .getJSON(url)
-        .pipe((0, operators_1.mergeMap)((response) => {
-        if (!(0, responsePayload_1.isSuccessResponse)(response) || response.data == null) {
-            return (0, rxjs_1.of)(payload.flowType === 'categorization'
-                ? (0, transactionsViewReducer_1.markCategoryClassRecommendationsFailureForCategorization)(payload.selectedTab, transactionId, lineIds, response.status)
-                : (0, transactionDetailReducer_1.markCategoryClassRecommendationsFailureForTransactionDetail)(transactionId, lineIds, response.status));
-        }
-        const recommendationWithCOTByLineId = (0, recommendationHelper_1.getRecommendationByLineIdWithCOTFromRecommendationPayloadWithCOT)(response.data.recommendations, lineIds);
-        // HTTP 200 with no per-line recommendations: NOT an error.
-        // Flip lines to Completed so the skeleton resolves and
-        // downstream UI can treat this as "we tried, nothing to
-        // apply".
-        if (recommendationWithCOTByLineId == null) {
-            return (0, rxjs_1.of)(payload.flowType === 'categorization'
-                ? (0, transactionsViewReducer_1.markCategoryClassRecommendationsCompletedForCategorization)(payload.selectedTab, transactionId, lineIds)
-                : (0, transactionDetailReducer_1.markCategoryClassRecommendationsCompletedForTransactionDetail)(transactionId, lineIds));
-        }
-        const transactionWithCOT = isFetchCOT === true
-            ? (0, transactionHelper_1.getTransactionWithCOTFromRecommendations)(transaction, recommendationWithCOTByLineId)
-            : (0, transactionHelper_1.getTransactionWithCOT)(transaction);
-        const uncategorizedIncomeExpense = (0, accountListSelector_1.getUncategorizedAccounts)(state$.value.accountState, state$.value.accountListState, 'accountList');
-        if (payload.flowType === 'categorization') {
-            return (0, rxjs_1.of)((0, transactionsViewReducer_1.setEntityRecommendationForLineIdsForCategorization)(payload.selectedTab, transactionId, transactionWithCOT, lineIds, entity, amount, recommendationWithCOTByLineId, uncategorizedIncomeExpense, isUncategorizedExpenseCategoryEnabled, (0, tenantSelector_1.getIsAccountingClassesEnabled)(state$.value)));
-        }
-        return (0, rxjs_1.of)((0, transactionDetailReducer_1.setEntityRecommendationForLineIdsForTransactionDetail)(transactionId, transactionWithCOT, lineIds, entity, amount, recommendationWithCOTByLineId, uncategorizedIncomeExpense));
-    }), (0, operators_1.catchError)((error) => {
-        const errorMessage = 'fetchEntityRecommendationsForLineUpdate failed: ' +
-            (error instanceof Error
-                ? error.message
-                : JSON.stringify(error));
-        const status = (0, responsePayload_1.createZeniAPIStatus)('Unexpected Error', errorMessage);
-        return (0, rxjs_1.of)(payload.flowType === 'categorization'
-            ? (0, transactionsViewReducer_1.markCategoryClassRecommendationsFailureForCategorization)(payload.selectedTab, transactionId, lineIds, status)
-            : (0, transactionDetailReducer_1.markCategoryClassRecommendationsFailureForTransactionDetail)(transactionId, lineIds, status));
-    }));
-    return (0, rxjs_1.concat)((0, rxjs_1.of)(startAction), httpStream$);
-}))));
-exports.fetchEntityRecommendationsForLineUpdateEpic = fetchEntityRecommendationsForLineUpdateEpic;