@zeniai/client-epic-state 5.0.73 → 5.0.74

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (46) hide show
  1. package/lib/commonStateTypes/filterPrimitives.d.ts +23 -0
  2. package/lib/commonStateTypes/filterPrimitives.js +21 -0
  3. package/lib/entity/account/accountSelector.d.ts +26 -0
  4. package/lib/entity/account/accountSelector.js +47 -1
  5. package/lib/entity/account/accountState.d.ts +5 -0
  6. package/lib/entity/account/accountState.js +11 -4
  7. package/lib/entity/class/classSelector.d.ts +35 -0
  8. package/lib/entity/class/classSelector.js +50 -0
  9. package/lib/esm/commonStateTypes/filterPrimitives.js +20 -0
  10. package/lib/esm/entity/account/accountSelector.js +46 -1
  11. package/lib/esm/entity/account/accountState.js +7 -1
  12. package/lib/esm/entity/class/classSelector.js +48 -0
  13. package/lib/esm/index.js +10 -4
  14. package/lib/esm/view/companyHealthMetricView/companyHealthMetricViewSelector.js +1 -1
  15. package/lib/esm/view/companyView/helpers/cockpitHelpers.js +1 -1
  16. package/lib/esm/view/companyView/selector/companyManagementViewSelector.js +1 -1
  17. package/lib/esm/view/companyView/selector/companyPortfolioViewSelector.js +1 -1
  18. package/lib/esm/view/expenseAutomationView/reducers/transactionsViewReducer.js +11 -1
  19. package/lib/esm/view/expenseAutomationView/selectors/transactionCategorizationSelector.js +69 -12
  20. package/lib/esm/view/expenseAutomationView/transactionFilterHelpers.js +258 -0
  21. package/lib/esm/view/spendManagement/spendManagementFilterHelpers.js +4 -2
  22. package/lib/esm/view/subscriptionView/subscriptionViewSelector.js +1 -1
  23. package/lib/esm/view/taskManager/taskListView/taskListReducer.js +1 -1
  24. package/lib/index.d.ts +7 -5
  25. package/lib/index.js +41 -32
  26. package/lib/view/companyHealthMetricView/companyHealthMetricViewSelector.js +1 -1
  27. package/lib/view/companyView/helpers/cockpitHelpers.js +1 -1
  28. package/lib/view/companyView/selector/companyManagementViewSelector.js +1 -1
  29. package/lib/view/companyView/selector/companyPortfolioViewSelector.js +1 -1
  30. package/lib/view/companyView/types/cockpitTypes.d.ts +1 -1
  31. package/lib/view/expenseAutomationView/reducers/transactionsViewReducer.d.ts +5 -1
  32. package/lib/view/expenseAutomationView/reducers/transactionsViewReducer.js +12 -2
  33. package/lib/view/expenseAutomationView/selectors/transactionCategorizationSelector.d.ts +4 -1
  34. package/lib/view/expenseAutomationView/selectors/transactionCategorizationSelector.js +71 -12
  35. package/lib/view/expenseAutomationView/transactionFilterHelpers.d.ts +66 -0
  36. package/lib/view/expenseAutomationView/transactionFilterHelpers.js +262 -0
  37. package/lib/view/expenseAutomationView/types/transactionsViewState.d.ts +2 -0
  38. package/lib/view/spendManagement/billPay/billList/billListState.d.ts +1 -1
  39. package/lib/view/spendManagement/chargeCards/chargeCardPaymentHistory/chargeCardPaymentHistory.d.ts +1 -1
  40. package/lib/view/spendManagement/reimbursement/remiListView/remiListState.d.ts +1 -1
  41. package/lib/view/spendManagement/spendManagementFilterHelpers.d.ts +12 -3
  42. package/lib/view/spendManagement/spendManagementFilterHelpers.js +4 -2
  43. package/lib/view/subscriptionView/subscriptionViewSelector.js +1 -1
  44. package/lib/view/taskManager/taskListView/taskList.d.ts +1 -1
  45. package/lib/view/taskManager/taskListView/taskListReducer.js +1 -1
  46. package/package.json +1 -1
@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
3
3
  return (mod && mod.__esModule) ? mod : { "default": mod };
4
4
  };
5
5
  Object.defineProperty(exports, "__esModule", { value: true });
6
+ exports.toTransactionView = void 0;
6
7
  exports.getExpenseAutomationTransactionView = getExpenseAutomationTransactionView;
7
8
  const omit_1 = __importDefault(require("lodash/omit"));
8
9
  const reduceFetchState_1 = require("../../../commonStateTypes/reduceFetchState");
@@ -10,14 +11,34 @@ const timePeriod_1 = require("../../../commonStateTypes/timePeriod");
10
11
  const tenantSelector_1 = require("../../../entity/tenant/tenantSelector");
11
12
  const transactionHelper_1 = require("../../../entity/transaction/transactionHelper");
12
13
  const transactionSelector_1 = require("../../../entity/transaction/transactionSelector");
14
+ const transactionFilterHelpers_1 = require("../transactionFilterHelpers");
13
15
  const accountListSelector_1 = require("../../accountList/accountListSelector");
14
16
  const classListSelector_1 = require("../../classList/classListSelector");
15
17
  const projectListSelector_1 = require("../../projectList/projectListSelector");
16
18
  const expenseAutomationViewSelectorTypes_1 = require("../selectorTypes/expenseAutomationViewSelectorTypes");
19
+ const toTransactionView = (transaction, transactionLocalData) => {
20
+ return {
21
+ id: transaction.id,
22
+ date: transaction.date,
23
+ amount: transaction.amount,
24
+ vendorName: transaction.vendorName,
25
+ customerName: transaction.customerName,
26
+ vendorId: transaction.vendorId,
27
+ customerId: transaction.customerId,
28
+ description: transaction.description,
29
+ memo: transaction.memo,
30
+ type: transaction.type,
31
+ typeName: transaction.typeName,
32
+ createTime: transaction.createTime,
33
+ transaction: transaction,
34
+ transactionLocalData,
35
+ };
36
+ };
37
+ exports.toTransactionView = toTransactionView;
17
38
  function getExpenseAutomationTransactionView(state) {
18
39
  const { accountState, classState, classListState, accountListState, expenseAutomationTransactionsViewState, expenseAutomationViewState, projectState, projectListState, transactionState, monthEndCloseChecksState, monthEndCloseChecksViewState, } = state;
19
40
  const { selectedTransactionCategorizationCompletedSubTab, selectedTransactionCategorizationTab, } = expenseAutomationTransactionsViewState;
20
- const { uiState, refreshStatus, saveStatus, markAsNotMiscategorizedStatus, transactionIdsBySelectedPeriod, transactionReviewLocalDataById, selectedCheckBoxTransactionIds, transactionIdsWithUnsavedData, uploadReceiptStatusById, selectedTransactionId, selectedTransactionLineId, } = expenseAutomationTransactionsViewState.transactionCategorizationView[selectedTransactionCategorizationTab];
41
+ const { uiState, refreshStatus, saveStatus, markAsNotMiscategorizedStatus, transactionIdsBySelectedPeriod, transactionReviewLocalDataById, selectedCheckBoxTransactionIds, transactionIdsWithUnsavedData, uploadReceiptStatusById, selectedTransactionId, selectedTransactionLineId, filters, } = expenseAutomationTransactionsViewState.transactionCategorizationView[selectedTransactionCategorizationTab];
21
42
  const uncategorizedIncomeExpense = (0, accountListSelector_1.getUncategorizedAccounts)(accountState, accountListState, 'accountList');
22
43
  const accountList = (0, accountListSelector_1.getAccountList)(accountState, accountListState, 'accountList');
23
44
  const classList = (0, classListSelector_1.getClassList)(classState, classListState);
@@ -36,20 +57,58 @@ function getExpenseAutomationTransactionView(state) {
36
57
  ? transactionIdsBySelectedPeriod[monthYearPeriodId]
37
58
  : null;
38
59
  const transactionIds = transactionIdsForSelectedPeriod ?? [];
39
- const transactionLocalData = transactionIds
40
- .map((transactionId) => {
60
+ const transactions = (0, transactionSelector_1.getSupportedTransactionsByIds)(transactionState, transactionIds);
61
+ const transactionsWithCOT = transactions.map((transaction) => (0, transactionHelper_1.getTransactionWithCOT)(transaction));
62
+ const transactionLocalDataMap = new Map();
63
+ transactionIds.forEach((transactionId) => {
41
64
  const transactionData = transactionReviewLocalDataById[transactionId];
42
65
  if (transactionData != null) {
43
- return {
66
+ transactionLocalDataMap.set(transactionId, {
44
67
  transactionId,
45
68
  transactionReviewLocalData: transactionData.transactionReviewLocalData,
46
- };
69
+ });
47
70
  }
48
- return null;
49
- })
50
- .filter((transaction) => transaction != null);
51
- const transactions = (0, transactionSelector_1.getSupportedTransactionsByIds)(transactionState, transactionIds);
52
- const transactionsWithCOT = transactions.map((transaction) => (0, transactionHelper_1.getTransactionWithCOT)(transaction));
71
+ });
72
+ // Step 2: Convert to TransactionView and apply advanced filters
73
+ const transactionViews = transactionsWithCOT.map((transaction) => {
74
+ const localData = transactionLocalDataMap.get(transaction.id);
75
+ return (0, exports.toTransactionView)(transaction, localData);
76
+ });
77
+ // Apply TC-specific filters (lives under expenseAutomationView, independent
78
+ // of the Spend Management filter pipeline).
79
+ const filteredTransactionViews = (0, transactionFilterHelpers_1.applyTransactionFilters)(transactionViews, filters);
80
+ // Convert back to TransactionWithCOT for return
81
+ const filteredTransactionsWithCOT = filteredTransactionViews.map((view) => view.transaction);
82
+ // Get transactionLocalData for filtered transactions
83
+ // Also include transactionLocalData for transactions that don't exist in transactionState
84
+ // but have local data (to match original behavior)
85
+ const filteredTransactionIds = new Set(filteredTransactionViews.map((view) => view.id));
86
+ // Pre-compute the membership set once. The previous implementation called
87
+ // `transactions.some(t => t.id === transactionId)` inside the per-id loop,
88
+ // turning the pipeline into O(n × m) — measurable on tenants with large
89
+ // transaction lists since this selector runs on every Redux dispatch.
90
+ const transactionExistsById = new Set(transactions.map((t) => t.id));
91
+ // `.flatMap` returns `X[]` directly when the callback returns `[]` for the
92
+ // skip case, so we don't need the trailing `.filter((d): d is X => …)` type
93
+ // predicate that the previous `map → filter` pipeline required.
94
+ const filteredTransactionLocalData = transactionIds.flatMap((transactionId) => {
95
+ const transactionData = transactionReviewLocalDataById[transactionId];
96
+ if (transactionData == null) {
97
+ return [];
98
+ }
99
+ // Include if transaction is in filtered results, or if transaction doesn't exist in state
100
+ // (to maintain backward compatibility with tests)
101
+ const transactionExists = transactionExistsById.has(transactionId);
102
+ if (filteredTransactionIds.has(transactionId) || !transactionExists) {
103
+ return [
104
+ {
105
+ transactionId,
106
+ transactionReviewLocalData: transactionData.transactionReviewLocalData,
107
+ },
108
+ ];
109
+ }
110
+ return [];
111
+ });
53
112
  const monthEndFetchState = monthYearPeriodId != null
54
113
  ? (monthEndCloseChecksViewState.monthEndCloseChecksViewByTenantId[currentTenant.tenantId]?.[monthYearPeriodId] ?? { fetchState: 'Not-Started', error: undefined })
55
114
  : { fetchState: 'Not-Started', error: undefined };
@@ -113,7 +172,7 @@ function getExpenseAutomationTransactionView(state) {
113
172
  version: 0,
114
173
  fetchState: fetchStatus.fetchState,
115
174
  error: fetchStatus.error,
116
- transactions: transactionsWithCOT,
175
+ transactions: filteredTransactionsWithCOT,
117
176
  selectedCheckBoxTransactionIds,
118
177
  transactionIdsWithUnsavedData,
119
178
  uncategorizedAccounts: uncategorizedIncomeExpense,
@@ -124,7 +183,7 @@ function getExpenseAutomationTransactionView(state) {
124
183
  classHierarchyList,
125
184
  isAccountingProjectsEnabled,
126
185
  projectList,
127
- transactionLocalData,
186
+ transactionLocalData: filteredTransactionLocalData,
128
187
  uiState,
129
188
  refreshStatus,
130
189
  saveStatus,
@@ -0,0 +1,66 @@
1
+ /**
2
+ * Filter machinery for the Transaction Categorization feature inside
3
+ * Expense Automation. Intentionally self-contained — does NOT import anything
4
+ * from `view/spendManagement/*`, because Transaction Categorization is not a
5
+ * Spend Management product. Shared primitives
6
+ * (`CategoryCombinationOperator`, `FilterCategoryType`) come from
7
+ * `commonStateTypes/filterPrimitives`, which both feature groups consume.
8
+ */
9
+ import { Amount } from '../../commonStateTypes/amount';
10
+ import { ID } from '../../commonStateTypes/common';
11
+ import { CategoryCombinationOperator, FilterCategoryType } from '../../commonStateTypes/filterPrimitives';
12
+ import { TransactionType } from '../../entity/transaction/stateTypes/transactionType';
13
+ import { SupportedTransactionWithCOT } from '../../entity/transaction/transactionState';
14
+ import { ZeniDate } from '../../zeniDayJS';
15
+ import { TransactionReviewLocalDataSelectorView } from './selectorTypes/transactionsViewSelectorTypes';
16
+ /**
17
+ * Re-exported here so the CES barrel can pull TC's primitives from the
18
+ * Expense Automation surface without reaching into `commonStateTypes`
19
+ * directly — keeps the barrel's existing import topology stable.
20
+ */
21
+ export type { CategoryCombinationOperator, FilterCategoryType };
22
+ export type TransactionFilterEntityType = 'transaction_categorization' | 'customer' | 'vendor' | 'merchant';
23
+ export type TransactionFilterCategoryField = 'payment_account_name' | 'payment_account_type' | 'payee' | 'category' | 'class' | 'amount';
24
+ export interface TransactionFilterCategoryDropdownOption {
25
+ value: TransactionFilterCategoryField;
26
+ multiple?: boolean;
27
+ type?: FilterCategoryType;
28
+ }
29
+ export declare const TRANSACTION_FILTER_CATEGORIES: TransactionFilterCategoryDropdownOption[];
30
+ /** Amount filter operators for transaction_categorization. */
31
+ export type TransactionFilterAmountMatchingOperator = 'equal' | 'not_equal' | 'less_than' | 'greater_than' | 'in_between';
32
+ export interface TransactionFilterCategory {
33
+ field: TransactionFilterCategoryField;
34
+ matchingOperator: TransactionFilterAmountMatchingOperator;
35
+ values: (string | number)[];
36
+ valuesCombinationOperator: 'ANY';
37
+ }
38
+ export interface TransactionFilters {
39
+ categories: TransactionFilterCategory[];
40
+ categoryCombinationOperator: CategoryCombinationOperator;
41
+ }
42
+ export interface TransactionView {
43
+ amount: Amount;
44
+ createTime: ZeniDate;
45
+ date: ZeniDate;
46
+ description: string;
47
+ id: ID;
48
+ memo: string;
49
+ transaction: SupportedTransactionWithCOT;
50
+ type: TransactionType;
51
+ customerId?: ID;
52
+ customerName?: string;
53
+ transactionLocalData?: TransactionReviewLocalDataSelectorView;
54
+ typeName?: string;
55
+ vendorId?: ID;
56
+ vendorName?: string;
57
+ }
58
+ /**
59
+ * TC-only equivalent of `applyAdvancedFiltersOnList`. Filters a list of
60
+ * `TransactionView` items against a `TransactionFilters` object using the
61
+ * AND/OR combination semantics from `categoryCombinationOperator`.
62
+ *
63
+ * Independent of `view/spendManagement` — keeps the TC filter pipeline cleanly
64
+ * inside the Expense Automation feature group.
65
+ */
66
+ export declare const applyTransactionFilters: (transactions: TransactionView[], filters?: TransactionFilters) => TransactionView[];
@@ -0,0 +1,262 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.applyTransactionFilters = exports.TRANSACTION_FILTER_CATEGORIES = void 0;
4
+ /**
5
+ * Narrowing type-guard for "has a non-empty string here". Used in place of
6
+ * raw `if (foo)` truthiness checks on `string | null | undefined` values so
7
+ * the `@typescript-eslint/strict-boolean-expressions` lint stays clean —
8
+ * empty strings should explicitly fall through to the next candidate
9
+ * (vendorName → customerName → localData.vendor.name → ...) rather than
10
+ * being implicitly coerced to falsy.
11
+ */
12
+ const isNonEmptyString = (s) => s != null && s !== '';
13
+ /**
14
+ * First line item in UI order. `lineItemById` is a Record whose iteration
15
+ * order is not guaranteed to match what the user sees; `sortedLineItems`
16
+ * is the canonical ordering used by the categorization list/detail views.
17
+ */
18
+ const getFirstLineItemFromReviewLocalData = (localData) => {
19
+ const { sortedLineItems, lineItemById } = localData;
20
+ if (sortedLineItems.length > 0) {
21
+ return lineItemById[sortedLineItems[0]];
22
+ }
23
+ const lineItems = Object.values(lineItemById);
24
+ return lineItems.length > 0 ? lineItems[0] : undefined;
25
+ };
26
+ exports.TRANSACTION_FILTER_CATEGORIES = [
27
+ { value: 'payment_account_name', type: 'dropdown' },
28
+ { value: 'payment_account_type', type: 'dropdown' },
29
+ { value: 'payee', type: 'searchAutocomplete' },
30
+ { value: 'category', type: 'dropdown' },
31
+ { value: 'class', type: 'dropdown' },
32
+ { value: 'amount', type: 'numberRange' },
33
+ ];
34
+ /**
35
+ * Resolve the comparable value for a transaction against a given filter field.
36
+ * Returns undefined when the transaction doesn't carry the field — callers
37
+ * decide whether absence counts as a match (for 'not_equal' it does).
38
+ */
39
+ const getCategoryValueForTransaction = (key, transaction) => {
40
+ switch (key) {
41
+ case 'amount': {
42
+ // Prefer transactionLocalData line items (sum). Fall back to lines on
43
+ // the transaction itself. Final fallback: transaction-level amount.
44
+ const localDataForAmount = transaction.transactionLocalData?.transactionReviewLocalData;
45
+ if (localDataForAmount?.lineItemById) {
46
+ const lineItems = Object.values(localDataForAmount.lineItemById);
47
+ if (lineItems.length > 0) {
48
+ return lineItems.reduce((sum, lineItem) => sum + (lineItem.amount?.amount ?? 0), 0);
49
+ }
50
+ }
51
+ if (transaction.transaction.lines &&
52
+ transaction.transaction.lines.length > 0) {
53
+ return transaction.transaction.lines.reduce((sum, line) => sum + (line.amount?.amount ?? 0), 0);
54
+ }
55
+ return transaction.amount.amount;
56
+ }
57
+ case 'payee': {
58
+ if (isNonEmptyString(transaction.vendorName)) {
59
+ return transaction.vendorName;
60
+ }
61
+ if (isNonEmptyString(transaction.customerName)) {
62
+ return transaction.customerName;
63
+ }
64
+ const localData = transaction.transactionLocalData?.transactionReviewLocalData;
65
+ const vendorName = localData?.vendor?.name;
66
+ if (isNonEmptyString(vendorName)) {
67
+ return vendorName;
68
+ }
69
+ const customerName = localData?.customer?.name;
70
+ if (isNonEmptyString(customerName)) {
71
+ return customerName;
72
+ }
73
+ return undefined;
74
+ }
75
+ case 'payment_account_name': {
76
+ // Match what TransactionCategorizationListRow renders for the cell.
77
+ return transaction.transaction.account?.accountName;
78
+ }
79
+ case 'payment_account_type': {
80
+ // Raw `paymentType` enum ("credit_card" / "check" / "cash"). Dropdown
81
+ // option values use the same enum; row uses `paymentTypeName` for the
82
+ // human label.
83
+ return transaction.transaction.paymentType;
84
+ }
85
+ case 'category': {
86
+ const localDataForCategory = transaction.transactionLocalData?.transactionReviewLocalData;
87
+ if (localDataForCategory != null) {
88
+ const firstLineItem = getFirstLineItemFromReviewLocalData(localDataForCategory);
89
+ const accountId = firstLineItem?.account?.accountId;
90
+ if (isNonEmptyString(accountId)) {
91
+ return accountId;
92
+ }
93
+ const qboId = firstLineItem?.account?.qboId;
94
+ if (isNonEmptyString(qboId)) {
95
+ return qboId;
96
+ }
97
+ const accountName = firstLineItem?.account?.accountName;
98
+ if (isNonEmptyString(accountName)) {
99
+ return accountName;
100
+ }
101
+ }
102
+ const firstLineForCategory = transaction.transaction.lines?.[0];
103
+ if (firstLineForCategory?.type ===
104
+ 'transaction_with_account_and_class_line' ||
105
+ firstLineForCategory?.type ===
106
+ 'transaction_with_product_or_service_line' ||
107
+ firstLineForCategory?.type === 'journal_entry_transaction_line') {
108
+ const account = firstLineForCategory.account;
109
+ return account?.accountId ?? account?.qboId ?? account?.accountName;
110
+ }
111
+ return undefined;
112
+ }
113
+ case 'class': {
114
+ const localDataForClass = transaction.transactionLocalData?.transactionReviewLocalData;
115
+ if (localDataForClass != null) {
116
+ const firstLineItemForClass = getFirstLineItemFromReviewLocalData(localDataForClass);
117
+ const classId = firstLineItemForClass?.class?.classId;
118
+ if (isNonEmptyString(classId)) {
119
+ return classId;
120
+ }
121
+ const qboId = firstLineItemForClass?.class?.qboId;
122
+ if (isNonEmptyString(qboId)) {
123
+ return qboId;
124
+ }
125
+ const className = firstLineItemForClass?.class?.className;
126
+ if (isNonEmptyString(className)) {
127
+ return className;
128
+ }
129
+ }
130
+ const firstLineForClass = transaction.transaction.lines?.[0];
131
+ if (firstLineForClass?.type === 'transaction_with_account_and_class_line' ||
132
+ firstLineForClass?.type ===
133
+ 'transaction_with_product_or_service_line' ||
134
+ firstLineForClass?.type === 'journal_entry_transaction_line') {
135
+ const classData = firstLineForClass.class;
136
+ return classData?.classId ?? classData?.qboId ?? classData?.className;
137
+ }
138
+ return undefined;
139
+ }
140
+ default:
141
+ return undefined;
142
+ }
143
+ };
144
+ /**
145
+ * TC-only amount matcher. Supports all five operators TC defines, including
146
+ * the legacy "1000<->5000" range-string form (kept for backward compatibility
147
+ * with persisted filter state that may still contain that encoding).
148
+ *
149
+ * The `'equal' | 'not_equal'` branch matches if `amount` equals ANY of the
150
+ * configured values (consistent with how non-amount filters interpret a
151
+ * multi-value `values` array). `.some()` over the values array also makes
152
+ * the empty-values case behave correctly — empty array → `matched = false`
153
+ * — though in practice `applyTransactionFilters` strips empty-values
154
+ * categories before they reach this matcher. The trailing
155
+ * `op === 'not_equal' ? !matched : matched` line inverts for `not_equal`.
156
+ */
157
+ const matchAmount = (amount, category) => {
158
+ const op = category.matchingOperator;
159
+ const values = category.values;
160
+ let matched = false;
161
+ if (op === 'in_between') {
162
+ if (values.length >= 2) {
163
+ const min = Number(values[0]);
164
+ const max = Number(values[1]);
165
+ matched = amount >= min && amount <= max;
166
+ }
167
+ }
168
+ else if (op === 'less_than') {
169
+ if (values.length >= 1) {
170
+ matched = amount < Number(values[0]);
171
+ }
172
+ }
173
+ else if (op === 'greater_than') {
174
+ if (values.length >= 1) {
175
+ matched = amount > Number(values[0]);
176
+ }
177
+ }
178
+ else if (op === 'equal' || op === 'not_equal') {
179
+ matched = values.some((v) => {
180
+ const s = String(v);
181
+ // Backward compatibility: legacy "low<->high" range-string form
182
+ // persisted under `matchingOperator: 'equal'`.
183
+ if (s.includes('<->')) {
184
+ const parts = s.split('<->');
185
+ return (amount >= Number(parts[0] ?? '') && amount <= Number(parts[1] ?? ''));
186
+ }
187
+ return amount === Number(v);
188
+ });
189
+ }
190
+ return op === 'not_equal' ? !matched : matched;
191
+ };
192
+ const transactionMatchesCategory = (transaction, category) => {
193
+ const value = getCategoryValueForTransaction(category.field, transaction);
194
+ if (value == null) {
195
+ // Absent-value semantics — pinning these down explicitly so the
196
+ // asymmetry isn't surprising:
197
+ //
198
+ // not_equal: a missing value IS NOT EQUAL to any candidate, so the
199
+ // transaction matches the filter (passes through).
200
+ // equal: a missing value is not equal to any candidate, so the
201
+ // transaction does NOT match (filtered out).
202
+ // less_than / greater_than: SQL-style three-valued logic — comparing
203
+ // against a missing value is "unknown", which we treat as
204
+ // "does not match" (filtered out). A user setting
205
+ // "amount < $1000" probably wants transactions with a
206
+ // concrete amount that satisfies the bound, not rows
207
+ // where the amount can't be determined.
208
+ // in_between: same as the single-sided comparators — missing values
209
+ // are filtered out.
210
+ //
211
+ // Only the `not_equal` branch returns `true` here; everything else
212
+ // falls through to the `false` below.
213
+ return category.matchingOperator === 'not_equal';
214
+ }
215
+ if (category.field === 'amount') {
216
+ return matchAmount(Number(value), category);
217
+ }
218
+ const valueStr = value.toString();
219
+ const valueInList = category.values.some((v) => v.toString() === valueStr);
220
+ return category.matchingOperator === 'not_equal' ? !valueInList : valueInList;
221
+ };
222
+ /**
223
+ * TC-only equivalent of `applyAdvancedFiltersOnList`. Filters a list of
224
+ * `TransactionView` items against a `TransactionFilters` object using the
225
+ * AND/OR combination semantics from `categoryCombinationOperator`.
226
+ *
227
+ * Independent of `view/spendManagement` — keeps the TC filter pipeline cleanly
228
+ * inside the Expense Automation feature group.
229
+ */
230
+ const applyTransactionFilters = (transactions, filters) => {
231
+ if (filters?.categories == null || filters.categories.length === 0) {
232
+ return transactions;
233
+ }
234
+ // Mirrors the predicate used by `getTransactionAppliedFiltersCount` on the
235
+ // webc side. A half-filled category — e.g. `in_between` with only the
236
+ // `min` typed — would otherwise survive the filter pass and produce zero
237
+ // matches because `Number("")` collapses to `0`, artificially emptying
238
+ // the list while editing. Skipping such categories keeps the filtered
239
+ // view stable while the user finishes typing.
240
+ const activeCategories = filters.categories.filter((c) => {
241
+ if (c.field == null || c.values.length === 0) {
242
+ return false;
243
+ }
244
+ if (c.field === 'amount' && c.matchingOperator === 'in_between') {
245
+ return (c.values.length >= 2 &&
246
+ String(c.values[0] ?? '').trim() !== '' &&
247
+ String(c.values[1] ?? '').trim() !== '');
248
+ }
249
+ return String(c.values[0] ?? '').trim() !== '';
250
+ });
251
+ if (activeCategories.length === 0) {
252
+ return transactions;
253
+ }
254
+ const op = filters.categoryCombinationOperator;
255
+ return transactions.filter((txn) => {
256
+ if (op === 'AND') {
257
+ return activeCategories.every((cat) => transactionMatchesCategory(txn, cat));
258
+ }
259
+ return activeCategories.some((cat) => transactionMatchesCategory(txn, cat));
260
+ });
261
+ };
262
+ exports.applyTransactionFilters = applyTransactionFilters;
@@ -16,6 +16,7 @@ import { VendorBase } from '../../../entity/vendor/vendorState';
16
16
  import { ZeniAPIStatus } from '../../../responsePayload';
17
17
  import { ZeniDate } from '../../../zeniDayJS';
18
18
  import { EntityRecommendationKey } from '../../recommendation/recommendationState';
19
+ import { TransactionFilters } from '../transactionFilterHelpers';
19
20
  import { TransactionDetailKey } from '../../transactionDetail/transactionDetailState';
20
21
  import { CompletedSubTab } from './completedSubTab';
21
22
  export declare const toTransactionsSortKey: (v: string) => "date" | "amount" | "vendor" | "project" | "category" | "class" | "payment_account" | "transaction_type" | "memo_and_receipt";
@@ -93,6 +94,7 @@ export interface SupportedTransactionCategorization {
93
94
  }
94
95
  export declare const initialSupportedTransactionCategorization: SupportedTransactionCategorization;
95
96
  export interface TransactionsTabViewState extends FetchedState {
97
+ filters: TransactionFilters;
96
98
  markAsNotMiscategorizedStatus: FetchStateAndError;
97
99
  refreshStatus: FetchStateAndError;
98
100
  saveStatus: FetchStateAndError;
@@ -45,7 +45,7 @@ export interface BillPayFilters {
45
45
  }
46
46
  export interface BillPayFilterCategory {
47
47
  field: BillListViewFilterCategoryField;
48
- matchingOperator: 'equal' | 'not-equal';
48
+ matchingOperator: 'equal' | 'not_equal';
49
49
  values: (string | ZeniDate)[];
50
50
  valuesCombinationOperator: 'ANY';
51
51
  }
@@ -36,7 +36,7 @@ export interface PaymentHistoryFilters {
36
36
  }
37
37
  export interface PaymentHistoryFilterCategory {
38
38
  field: PaymentHistoryFilterCategoryField;
39
- matchingOperator: 'equal' | 'not-equal';
39
+ matchingOperator: 'equal' | 'not_equal';
40
40
  values: (string | ZeniDate)[];
41
41
  valuesCombinationOperator: 'ANY';
42
42
  }
@@ -46,7 +46,7 @@ export interface ReimbursementFilters {
46
46
  }
47
47
  export interface ReimbursementFilterCategory {
48
48
  field: RemiListViewFilterCategoryField;
49
- matchingOperator: 'equal' | 'not-equal';
49
+ matchingOperator: 'equal' | 'not_equal';
50
50
  values: (string | ZeniDate)[];
51
51
  valuesCombinationOperator: 'ANY';
52
52
  }
@@ -1,3 +1,4 @@
1
+ import { CategoryCombinationOperator, FilterCategoryType } from '../../commonStateTypes/filterPrimitives';
1
2
  import { TimePeriod } from '../../commonStateTypes/timePeriod';
2
3
  import { UserRoleType } from '../../entity/userRole/userRoleType';
3
4
  import { RootState } from '../../reducer';
@@ -12,12 +13,20 @@ import { ReimbursementView } from './reimbursement/remiListView/remiListSelector
12
13
  import { ReimbursementFilters, RemiListViewFilterCategoryField } from './reimbursement/remiListView/remiListState';
13
14
  export type SpendManagementFiltersType = BillPayFilters | ReimbursementFilters | TaskListFilters | PaymentHistoryFilters;
14
15
  export type SpendManagementFilterEntityType = 'bill_pay' | 'reimbursement' | 'task_management' | 'charge_card_payment_history';
15
- export type FilterCategoryType = 'searchAutocomplete' | 'user' | 'dateRange' | 'numberRange' | 'dropdown';
16
+ /**
17
+ * Re-exported here so consumers of `spendManagementFilterHelpers` keep
18
+ * their existing import path stable after the primitives moved to
19
+ * `commonStateTypes/filterPrimitives`. Downstream files (`taskList`,
20
+ * `remiListState`, `chargeCardPaymentHistory`, `billListState`) and the
21
+ * CES barrel still pull `CategoryCombinationOperator` / `FilterCategoryType`
22
+ * from this module — the source of truth is upstream but the surface is
23
+ * unchanged.
24
+ */
25
+ export type { CategoryCombinationOperator, FilterCategoryType };
16
26
  export interface MatchingOperatorDropdownOption {
17
27
  label: 'is' | 'is not';
18
- value: 'equal' | 'not-equal';
28
+ value: 'equal' | 'not_equal';
19
29
  }
20
- export type CategoryCombinationOperator = 'AND' | 'OR';
21
30
  export interface BillPayFilterCategoryDropdownOption {
22
31
  value: BillListViewFilterCategoryField;
23
32
  multiple?: boolean;
@@ -14,6 +14,8 @@ const helpers_1 = require("./helpers");
14
14
  const remiListSelector_1 = require("./reimbursement/remiListView/remiListSelector");
15
15
  const remiListState_1 = require("./reimbursement/remiListView/remiListState");
16
16
  //filters items against filter values representing a range. ex: date (from-to), amount(1k<-->5k)
17
+ // Spend Management uses only equal/not_equal — TC amount operators
18
+ // (inBetween, lessThan, greaterThan) live in the TC filter pipeline.
17
19
  const filterItemOnRangeCategoryType = (valueForItem, currentFilter) => {
18
20
  let doesItemFallInValueRange = false;
19
21
  const filterField = currentFilter.field;
@@ -47,7 +49,7 @@ const filterItemOnCategoriesWithSingleValue = (categoryValue, currentFilter, ran
47
49
  return filterItemOnRangeCategoryType(categoryValue, currentFilter);
48
50
  }
49
51
  // if filter category is not rangeType
50
- if (currentFilter.matchingOperator === 'not-equal') {
52
+ if (currentFilter.matchingOperator === 'not_equal') {
51
53
  return currentFilter.values.indexOf(categoryValue.toString()) === -1;
52
54
  }
53
55
  return currentFilter.values.indexOf(categoryValue.toString()) > -1;
@@ -121,7 +123,7 @@ const applyAdvancedFiltersOnList = (entity, allItems, filters, filteredItems = [
121
123
  ? getCategoryValueForTaskList(key, item)
122
124
  : getCategoryValueForPaymentHistory(key, item);
123
125
  if (categoryValue == null) {
124
- if (currentFilter.matchingOperator === 'not-equal') {
126
+ if (currentFilter.matchingOperator === 'not_equal') {
125
127
  return true;
126
128
  }
127
129
  return false;
@@ -217,7 +217,7 @@ const applyAdvancedFiltersOnCompaniesList = (allCompanies, filters, filteredComp
217
217
  const key = currentFilter.field;
218
218
  const categoryValue = getCategoryValueForCompany(key, company);
219
219
  if (categoryValue == null) {
220
- if (currentFilter.matchingOperator === 'not-equal') {
220
+ if (currentFilter.matchingOperator === 'not_equal') {
221
221
  return true;
222
222
  }
223
223
  return false;
@@ -44,7 +44,7 @@ export interface TaskListFilters {
44
44
  }
45
45
  export interface TaskFilterCategory {
46
46
  field: TaskListFilterCategoryField;
47
- matchingOperator: 'equal' | 'not-equal';
47
+ matchingOperator: 'equal' | 'not_equal';
48
48
  values: (string | ZeniDate)[];
49
49
  valuesCombinationOperator: 'ANY';
50
50
  }
@@ -70,7 +70,7 @@ exports.initialState = {
70
70
  categories: [
71
71
  {
72
72
  field: 'status',
73
- matchingOperator: 'not-equal',
73
+ matchingOperator: 'not_equal',
74
74
  values: ['resolved'],
75
75
  valuesCombinationOperator: 'ANY',
76
76
  },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@zeniai/client-epic-state",
3
- "version": "5.0.73",
3
+ "version": "5.0.74",
4
4
  "description": "Shared module between Web & Mobile containing required abstractions for state management, async network communication. ",
5
5
  "main": "lib/index.js",
6
6
  "module": "lib/esm/index.js",