@zeniai/client-epic-state 5.2.62-beta0ND → 5.2.62-beta1KB

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 (45) hide show
  1. package/lib/entity/snackbar/snackbarTypes.d.ts +1 -1
  2. package/lib/entity/snackbar/snackbarTypes.js +1 -0
  3. package/lib/entity/transaction/stateTypes/paymentType.d.ts +2 -2
  4. package/lib/entity/transaction/stateTypes/paymentType.js +9 -1
  5. package/lib/entity/transaction/stateTypes/printStatus.d.ts +4 -0
  6. package/lib/entity/transaction/stateTypes/printStatus.js +15 -0
  7. package/lib/epic.d.ts +4 -1
  8. package/lib/epic.js +6 -0
  9. package/lib/esm/entity/snackbar/snackbarTypes.js +1 -0
  10. package/lib/esm/entity/transaction/stateTypes/paymentType.js +9 -1
  11. package/lib/esm/entity/transaction/stateTypes/printStatus.js +11 -0
  12. package/lib/esm/epic.js +6 -0
  13. package/lib/esm/index.js +5 -2
  14. package/lib/esm/view/spendManagement/billPay/editBillView/editBillViewSelector.js +4 -30
  15. package/lib/esm/view/transactionDetail/createTransaction/createTransactionLocalDataHelper.js +133 -0
  16. package/lib/esm/view/transactionDetail/createTransaction/createTransactionPayload.js +124 -0
  17. package/lib/esm/view/transactionDetail/createTransaction/createTransactionSelector.js +41 -0
  18. package/lib/esm/view/transactionDetail/createTransaction/createTransactionState.js +11 -0
  19. package/lib/esm/view/transactionDetail/createTransaction/epics/createTransactionEpic.js +58 -0
  20. package/lib/esm/view/transactionDetail/createTransaction/epics/fetchVendorRecommendationsForCreateTransactionEpic.js +55 -0
  21. package/lib/esm/view/transactionDetail/createTransaction/epics/initializeCreateTransactionLocalDataEpic.js +14 -0
  22. package/lib/esm/view/transactionDetail/transactionDetailReducer.js +174 -1
  23. package/lib/index.d.ts +6 -2
  24. package/lib/index.js +57 -36
  25. package/lib/view/expenseAutomationView/helpers/transactionCategorizationLocalDataHelper.d.ts +1 -1
  26. package/lib/view/spendManagement/billPay/editBillView/editBillViewSelector.d.ts +1 -1
  27. package/lib/view/spendManagement/billPay/editBillView/editBillViewSelector.js +4 -30
  28. package/lib/view/transactionDetail/createTransaction/createTransactionLocalDataHelper.d.ts +51 -0
  29. package/lib/view/transactionDetail/createTransaction/createTransactionLocalDataHelper.js +148 -0
  30. package/lib/view/transactionDetail/createTransaction/createTransactionPayload.d.ts +82 -0
  31. package/lib/view/transactionDetail/createTransaction/createTransactionPayload.js +128 -0
  32. package/lib/view/transactionDetail/createTransaction/createTransactionSelector.d.ts +40 -0
  33. package/lib/view/transactionDetail/createTransaction/createTransactionSelector.js +48 -0
  34. package/lib/view/transactionDetail/createTransaction/createTransactionState.d.ts +81 -0
  35. package/lib/view/transactionDetail/createTransaction/createTransactionState.js +14 -0
  36. package/lib/view/transactionDetail/createTransaction/epics/createTransactionEpic.d.ts +9 -0
  37. package/lib/view/transactionDetail/createTransaction/epics/createTransactionEpic.js +62 -0
  38. package/lib/view/transactionDetail/createTransaction/epics/fetchVendorRecommendationsForCreateTransactionEpic.d.ts +20 -0
  39. package/lib/view/transactionDetail/createTransaction/epics/fetchVendorRecommendationsForCreateTransactionEpic.js +59 -0
  40. package/lib/view/transactionDetail/createTransaction/epics/initializeCreateTransactionLocalDataEpic.d.ts +12 -0
  41. package/lib/view/transactionDetail/createTransaction/epics/initializeCreateTransactionLocalDataEpic.js +18 -0
  42. package/lib/view/transactionDetail/transactionDetailReducer.d.ts +37 -1
  43. package/lib/view/transactionDetail/transactionDetailReducer.js +176 -2
  44. package/lib/view/transactionDetail/transactionDetailState.d.ts +12 -0
  45. package/package.json +26 -1
@@ -0,0 +1,124 @@
1
+ import { DEFAULT_DATE_FORMAT } from '../../../commonStateTypes/timePeriod';
2
+ import { getAccountBase } from '../../../entity/account/accountSelector';
3
+ import { getClassById } from '../../../entity/class/classSelector';
4
+ import { getVendorByVendorId } from '../../../entity/vendor/vendorSelector';
5
+ const toRemitToAddressPayload = (address) => {
6
+ if (address == null) {
7
+ return undefined;
8
+ }
9
+ return {
10
+ line1: address.line1,
11
+ city: address.city,
12
+ state: address.state,
13
+ postal_code: address.postalCode,
14
+ country: address.country,
15
+ };
16
+ };
17
+ const toLinePayload = (state, line, transactionType) => {
18
+ const lineDetail = {};
19
+ if (line.accountQboId != null) {
20
+ lineDetail.account = {
21
+ qbo_id: line.accountQboId,
22
+ account_name: line.accountName,
23
+ };
24
+ }
25
+ // An empty object is what the confirmed payloads send when no class is chosen; sending the
26
+ // key with a qbo_id only once one is picked.
27
+ const classQboId = toQboClassId(state, line.classId);
28
+ lineDetail.class = classQboId != null ? { qbo_id: classQboId } : {};
29
+ if (transactionType === 'journal_entry') {
30
+ lineDetail.posting_type = line.postingType;
31
+ if (line.vendorQboId != null) {
32
+ lineDetail.vendor = { qbo_id: line.vendorQboId };
33
+ }
34
+ }
35
+ return {
36
+ // The backend rejects a bool here, so this is always coerced to a number.
37
+ amount: line.amount?.amount ?? 0,
38
+ line_description: line.lineDescription,
39
+ line_detail_type: transactionType === 'journal_entry'
40
+ ? 'journal_entry_line_detail'
41
+ : 'account_based_expense_line_detail',
42
+ line_detail: lineDetail,
43
+ };
44
+ };
45
+ /** Resolves a Zeni account id to the QBO id the endpoint expects. */
46
+ const toQboAccountId = (state, accountId) => {
47
+ if (accountId == null) {
48
+ return undefined;
49
+ }
50
+ return (getAccountBase(state.accountState, accountId, 'account_list')?.qboId ??
51
+ accountId);
52
+ };
53
+ /** Resolves a Zeni class id (`class_<uuid>`) to the QBO id `line_detail.class.qbo_id` expects. */
54
+ const toQboClassId = (state, classId) => {
55
+ if (classId == null) {
56
+ return undefined;
57
+ }
58
+ return (getClassById(state.classState, { classId, reportId: 'class_list' })
59
+ ?.qboId ?? classId);
60
+ };
61
+ /** Resolves a Zeni vendor id to its QBO id -- `vendor_id` on the wire is a QBO id. */
62
+ const toQboVendorId = (state, vendorId) => {
63
+ if (vendorId == null) {
64
+ return undefined;
65
+ }
66
+ return getVendorByVendorId(state.vendorState, vendorId)?.qboId ?? vendorId;
67
+ };
68
+ /**
69
+ * Builds the request body for one transaction type. One branch per type rather than a shared
70
+ * body with optional keys, because the types genuinely diverge -- transfer carries no lines at
71
+ * all, and journal_entry carries no header account.
72
+ */
73
+ export const prepareCreateTransactionPayload = (state, localData) => {
74
+ const { transactionType } = localData;
75
+ const base = {
76
+ transaction_type: transactionType,
77
+ transaction_date: localData.transactionDate?.format(DEFAULT_DATE_FORMAT) ?? '',
78
+ transaction_memo: localData.transactionMemo,
79
+ };
80
+ if (transactionType === 'transfer') {
81
+ return {
82
+ ...base,
83
+ from_account_id: toQboAccountId(state, localData.fromAccountId),
84
+ to_account_id: toQboAccountId(state, localData.toAccountId),
85
+ total_amount: localData.totalAmount?.amount ?? 0,
86
+ };
87
+ }
88
+ const lines = localData.lines.map((line) => toLinePayload(state, line, transactionType));
89
+ if (transactionType === 'journal_entry') {
90
+ return {
91
+ ...base,
92
+ document_id: localData.documentId,
93
+ lines,
94
+ };
95
+ }
96
+ const purchaseBase = {
97
+ ...base,
98
+ payment_type: localData.paymentType,
99
+ qbo_account_id: toQboAccountId(state, localData.qboAccountId),
100
+ vendor_id: toQboVendorId(state, localData.vendorId),
101
+ lines,
102
+ };
103
+ if (transactionType === 'check') {
104
+ return {
105
+ ...purchaseBase,
106
+ document_number: localData.documentNumber,
107
+ print_status: localData.printStatus,
108
+ remit_to_address: toRemitToAddressPayload(localData.remitToAddress),
109
+ };
110
+ }
111
+ if (transactionType === 'credit_card_credit') {
112
+ // credit_card_credit is not in the backend's SUPPORTED_TRANSACTION_WRITE_TYPES. QBO models
113
+ // it as a Purchase with Credit: true and qbo_purchase.py already honours is_credit for
114
+ // card payment types, so this sends `expense` + is_credit rather than a type the validator
115
+ // rejects outright. Confirm with backend before enabling the menu item.
116
+ return {
117
+ ...purchaseBase,
118
+ transaction_type: 'expense',
119
+ is_credit: true,
120
+ document_number: localData.documentNumber,
121
+ };
122
+ }
123
+ return purchaseBase;
124
+ };
@@ -0,0 +1,41 @@
1
+ import { getNestedAccountListHierarchy } from '../../accountList/accountListSelector';
2
+ import { getNestedClassListHierarchy } from '../../classList/classListSelector';
3
+ import { getResolvedTransferAccounts } from '../../createTransferEntry/createTransferEntrySelector';
4
+ import { getRecommendationsForEntity } from '../../recommendation/recommendationSelector';
5
+ export const getCreateTransactionLocalData = (state, transactionType) => state.transactionDetailState.createTransactionsState.newTransactionState[transactionType];
6
+ export const getCreateTransactionStatus = (state) => state.transactionDetailState.createTransactionsState.createStatus;
7
+ /**
8
+ * The vendor recommendations backing the category/class dropdowns on the create page.
9
+ *
10
+ * No new state field is needed for this: getRecommendationsForEntity already returns
11
+ * fetchState alongside recommendations, so composing it here is enough for the page to show a
12
+ * line skeleton and hold Save while a fetch is in flight.
13
+ */
14
+ export const getCreateTransactionVendorRecommendations = (state, vendorQboId) => {
15
+ if (vendorQboId == null || vendorQboId === '') {
16
+ return { fetchState: 'Not-Started' };
17
+ }
18
+ const view = getRecommendationsForEntity(state, vendorQboId, 'vendor');
19
+ return {
20
+ fetchState: view.fetchState,
21
+ recommendations: view.recommendations,
22
+ };
23
+ };
24
+ export const getCreateTransactionView = (state, transactionType) => {
25
+ const { accountListState, classListState, transactionDetailState, vendorState, } = state;
26
+ const { createTransactionsState } = transactionDetailState;
27
+ return {
28
+ transactionType,
29
+ localData: createTransactionsState.newTransactionState[transactionType],
30
+ createStatus: createTransactionsState.createStatus,
31
+ createdTransactionId: createTransactionsState.createdTransactionId,
32
+ vendorList: Object.values(vendorState.vendorByID),
33
+ accountListNestedAccountHierarchy: getNestedAccountListHierarchy(accountListState, 'accountList'),
34
+ classListNestedAccountHierarchy: getNestedClassListHierarchy(classListState),
35
+ transferAccountsList: transactionType === 'transfer'
36
+ ? getResolvedTransferAccounts(state).transferAccountsList
37
+ : [],
38
+ fetchState: createTransactionsState.createStatus.fetchState,
39
+ error: createTransactionsState.createStatus.error,
40
+ };
41
+ };
@@ -0,0 +1,11 @@
1
+ /**
2
+ * The transaction types the Create Transaction flow can originate. A narrow subset of
3
+ * TransactionType -- everything else is read-only and arrives via sync.
4
+ */
5
+ export const ALL_CREATABLE_TRANSACTION_TYPES = [
6
+ 'expense',
7
+ 'check',
8
+ 'credit_card_credit',
9
+ 'transfer',
10
+ 'journal_entry',
11
+ ];
@@ -0,0 +1,58 @@
1
+ import { from } from 'rxjs';
2
+ import { catchError, filter, mergeMap } from 'rxjs/operators';
3
+ import { openSnackbar } from '../../../../entity/snackbar/snackbarReducer';
4
+ import { toTransactionID } from '../../../../entity/transaction/payloadTypes/transactionIDPayload';
5
+ import { updateTransaction } from '../../../../entity/transaction/transactionReducer';
6
+ import { createZeniAPIStatus, isSuccessResponse, } from '../../../../responsePayload';
7
+ import { createTransaction, createTransactionSuccessOrFailure, initializeTransactionDetailLocalData, resetCreateTransactionLocalData, } from '../../transactionDetailReducer';
8
+ import { getTransactionDetailKey } from '../../transactionDetailState';
9
+ import { prepareCreateTransactionPayload, } from '../createTransactionPayload';
10
+ const failureActions = (message, status) => [
11
+ createTransactionSuccessOrFailure('Error', undefined, status),
12
+ openSnackbar({
13
+ messageSection: 'create_transaction',
14
+ messageText: 'failed',
15
+ type: 'error',
16
+ // This variable is how the server's own message reaches the user. Per-type required
17
+ // fields live in the QBO entity classes, so a rejection comes back as a QBO error with no
18
+ // field name -- the message text is the only useful content we get.
19
+ variables: [{ variableName: '_api-error_', variableValue: message }],
20
+ }),
21
+ ];
22
+ export const createTransactionEpic = (actions$, state$, zeniAPI) => actions$.pipe(filter(createTransaction.match), mergeMap((action) => {
23
+ const { transactionType } = action.payload;
24
+ const state = state$.value;
25
+ const localData = state.transactionDetailState.createTransactionsState
26
+ .newTransactionState[transactionType];
27
+ const payload = prepareCreateTransactionPayload(state, localData);
28
+ return zeniAPI
29
+ .postAndGetJSON(`${zeniAPI.apiEndPoints.accountMicroServiceBaseUrl}/1.0/transactions/manage`, payload)
30
+ .pipe(mergeMap((response) => {
31
+ if (!isSuccessResponse(response) || response.data == null) {
32
+ return from(failureActions(response.status.message, response.status));
33
+ }
34
+ const created = response.data.transactions[0];
35
+ if (created == null) {
36
+ return from(failureActions('Transaction was created but returned no details.', createZeniAPIStatus('Unexpected Error', 'Create transaction returned an empty transactions array.')));
37
+ }
38
+ const newTransactionId = toTransactionID(created);
39
+ // The write is QBO-only: transaction_write_handler.py touches no local storage, and
40
+ // Zeni's mirror is populated by the delta sync that runs afterwards. Refetching here
41
+ // would come back without the new row, so the 200 body is inserted optimistically
42
+ // instead -- the same approach createTransferEntryEpic takes.
43
+ return from([
44
+ updateTransaction(getTransactionDetailKey(newTransactionId), created),
45
+ initializeTransactionDetailLocalData({
46
+ transactionId: newTransactionId,
47
+ vendorId: created.vendor_id ?? undefined,
48
+ }),
49
+ createTransactionSuccessOrFailure('Completed', newTransactionId),
50
+ resetCreateTransactionLocalData(transactionType),
51
+ openSnackbar({
52
+ messageSection: 'create_transaction',
53
+ messageText: 'success',
54
+ type: 'success',
55
+ }),
56
+ ]);
57
+ }), catchError((error) => from(failureActions(JSON.stringify(error), createZeniAPIStatus('Unexpected Error', `Create Transaction REST API call errored out ${JSON.stringify(error)}`)))));
58
+ }));
@@ -0,0 +1,55 @@
1
+ import { concat, from, of } from 'rxjs';
2
+ import { filter, mergeMap, switchMap, take } from 'rxjs/operators';
3
+ import { getIsAccountingClassesEnabled } from '../../../../entity/tenant/tenantSelector';
4
+ import { fetchRecommendationByEntityId, fetchRecommendationByEntityName, indicateReadyToInitializeRecommendation, } from '../../../recommendation/recommendationReducer';
5
+ import { getRecommendationsForEntity } from '../../../recommendation/recommendationSelector';
6
+ import { clearRecommendationsForCreateTransactionLines, fetchVendorRecommendationsForCreateTransaction, setRecommendationsForCreateTransactionLines, } from '../../transactionDetailReducer';
7
+ /**
8
+ * The entity-level recommendation fetch, keyed by whatever identifier the endpoint can resolve.
9
+ *
10
+ * A vendor that has not synced to QBO carries `qboId === name`; the id endpoint has nothing to
11
+ * look up in that case, so the by-name variant is used instead.
12
+ */
13
+ const toEntityIdOrName = (entity) => entity.qboId !== '' && entity.qboId !== entity.name
14
+ ? entity.qboId
15
+ : entity.name;
16
+ const isUnsyncedVendor = (entity) => entity.qboId === '' || entity.qboId === entity.name;
17
+ /**
18
+ * On vendor select, populates the category/class dropdowns from that vendor's recommendations.
19
+ *
20
+ * Deliberately NOT the detail page's fetchEntityRecommendationsForLineUpdate: that one sends
21
+ * transaction_id / line_ids and writes into transactionDetailById[key], which no-ops when the
22
+ * entry does not exist. A transaction being created has neither.
23
+ *
24
+ * Two differences from the reimbursement epic this is modelled on:
25
+ * 1. the wait filters on the matching entityIdOrName before take(1), so an unrelated
26
+ * recommendation landing first cannot satisfy this request, and
27
+ * 2. switchMap, so changing the vendor again cancels the earlier wait rather than letting a
28
+ * stale result overwrite the newer vendor's prefill.
29
+ */
30
+ export const fetchVendorRecommendationsForCreateTransactionEpic = (actions$, state$) => actions$.pipe(filter(fetchVendorRecommendationsForCreateTransaction.match), switchMap((action) => {
31
+ const { transactionType, entity, lineIds } = action.payload;
32
+ if (entity == null) {
33
+ return of(clearRecommendationsForCreateTransactionLines(transactionType, lineIds));
34
+ }
35
+ const entityIdOrName = toEntityIdOrName(entity);
36
+ const state = state$.value;
37
+ const isAccountingClassesEnabled = getIsAccountingClassesEnabled(state);
38
+ const cached = getRecommendationsForEntity(state, entityIdOrName, 'vendor');
39
+ // Cache hit: apply straight away, no request and no wait.
40
+ if (cached.fetchState === 'Completed') {
41
+ return of(setRecommendationsForCreateTransactionLines(transactionType, lineIds, cached.recommendations ?? [], isAccountingClassesEnabled));
42
+ }
43
+ const waitThenApply = actions$.pipe(filter(indicateReadyToInitializeRecommendation.match), filter((ready) => ready.payload.entityType === 'vendor' &&
44
+ ready.payload.entityIdOrName === entityIdOrName), take(1), // don't listen forever! IMPORTANT!
45
+ mergeMap(() => from([
46
+ setRecommendationsForCreateTransactionLines(transactionType, lineIds, getRecommendationsForEntity(state$.value, entityIdOrName, 'vendor').recommendations ?? [], getIsAccountingClassesEnabled(state$.value)),
47
+ ])));
48
+ // A fetch already in flight needs no second request, only the wait.
49
+ if (cached.fetchState === 'In-Progress') {
50
+ return waitThenApply;
51
+ }
52
+ return concat(of((isUnsyncedVendor(entity)
53
+ ? fetchRecommendationByEntityName(entityIdOrName, 'vendor')
54
+ : fetchRecommendationByEntityId(entityIdOrName, 'vendor'))), waitThenApply);
55
+ }));
@@ -0,0 +1,14 @@
1
+ import { filter, map } from 'rxjs/operators';
2
+ import { initializeCreateTransactionLocalData, updateCreateTransactionLocalData, } from '../../transactionDetailReducer';
3
+ import { getSeededCreateTransactionLocalData } from '../createTransactionLocalDataHelper';
4
+ /**
5
+ * Seeds the working copy when the Create form opens: today's date, the default line set for the
6
+ * type, and a check's mandatory payment_type.
7
+ *
8
+ * Mirrors the `else` branch of initializeScheduleDetailLocalDataEpic -- a create has no
9
+ * existing entity to read from, so there is nothing to merge, only defaults to apply.
10
+ */
11
+ export const initializeCreateTransactionLocalDataEpic = (actions$) => actions$.pipe(filter(initializeCreateTransactionLocalData.match), map((action) => {
12
+ const { transactionType } = action.payload;
13
+ return updateCreateTransactionLocalData(transactionType, getSeededCreateTransactionLocalData(transactionType));
14
+ }));
@@ -2,6 +2,7 @@ import { createSlice } from '@reduxjs/toolkit';
2
2
  import recordGet from 'lodash/get';
3
3
  import { toEntityType, } from '../../entity/genericEntity/entity';
4
4
  import { clearAll } from '../../rootActions';
5
+ import { applyRecommendationsToCreateTransactionLine, clearRecommendationsFromCreateTransactionLine, getInitialCreateTransactionLocalDataByType, getSeededCreateTransactionLocalData, mergeCreateTransactionLocalData, nextCreateTransactionLineId, updateCreateTransactionLine, } from './createTransaction/createTransactionLocalDataHelper';
5
6
  import { removeEntityRecommendationForLineIdInLocalData, setEntityRecommendationForLineIdInLocalData, toSetAllLineItemsLocalDataIsUpdateAllChecked, toSetAllLineItemsToCategoryClass, toSetAllLineItemsToVendor, toUpdateLineItemsOriginalCategoryClass, toUpdateLineItemsToOriginalVendor, } from './transactionDetailLocalDataHelper';
6
7
  import { getTransactionDetailKey, initialSupportedTransactionDetail, } from './transactionDetailState';
7
8
  export const initialState = {
@@ -10,6 +11,10 @@ export const initialState = {
10
11
  fetchState: 'Not-Started',
11
12
  attachmentDataByID: {},
12
13
  },
14
+ createTransactionsState: {
15
+ createStatus: { fetchState: 'Not-Started' },
16
+ newTransactionState: getInitialCreateTransactionLocalDataByType(),
17
+ },
13
18
  };
14
19
  const transactionDetail = createSlice({
15
20
  name: 'transactionDetail',
@@ -829,6 +834,174 @@ const transactionDetail = createSlice({
829
834
  };
830
835
  },
831
836
  },
837
+ // ---------------------------------------------------------------------------------
838
+ // Create Transaction
839
+ //
840
+ // These live on the transactionDetail slice rather than in createTransaction/ because a
841
+ // createSlice owns exactly one state object, and createTransactionsState is nested inside
842
+ // TransactionDetailState. The derivation itself stays in the folder -- each body below
843
+ // delegates to createTransactionLocalDataHelper.ts.
844
+ //
845
+ // They need no clearAll case of their own: the slice already resets to initialState on
846
+ // tenant switch, and createTransactionsState is part of it.
847
+ // ---------------------------------------------------------------------------------
848
+ /** Trigger only -- initializeCreateTransactionLocalDataEpic does the seeding. */
849
+ initializeCreateTransactionLocalData: {
850
+ reducer(
851
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
852
+ _draft,
853
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
854
+ _action) {
855
+ // no-op
856
+ },
857
+ prepare(transactionType) {
858
+ return { payload: { transactionType } };
859
+ },
860
+ },
861
+ updateCreateTransactionLocalData: {
862
+ reducer(draft, action) {
863
+ const { transactionType, localData } = action.payload;
864
+ const current = draft.createTransactionsState.newTransactionState[transactionType];
865
+ draft.createTransactionsState.newTransactionState[transactionType] =
866
+ mergeCreateTransactionLocalData(current, localData);
867
+ },
868
+ prepare(transactionType, localData) {
869
+ return { payload: { transactionType, localData } };
870
+ },
871
+ },
872
+ updateCreateTransactionLineLocalData: {
873
+ reducer(draft, action) {
874
+ const { transactionType, lineId, lineUpdates } = action.payload;
875
+ const current = draft.createTransactionsState.newTransactionState[transactionType];
876
+ current.lines = updateCreateTransactionLine(current.lines, lineId, lineUpdates);
877
+ },
878
+ prepare(transactionType, lineId, lineUpdates) {
879
+ return { payload: { transactionType, lineId, lineUpdates } };
880
+ },
881
+ },
882
+ /**
883
+ * `line` is supplied by the caller rather than built here, so a row added after a vendor is
884
+ * already chosen can arrive pre-populated from the cached recommendations instead of blank.
885
+ */
886
+ addCreateTransactionLine: {
887
+ reducer(draft, action) {
888
+ const { transactionType, line } = action.payload;
889
+ draft.createTransactionsState.newTransactionState[transactionType].lines.push({
890
+ ...line,
891
+ id: nextCreateTransactionLineId(),
892
+ });
893
+ },
894
+ prepare(transactionType, line) {
895
+ return { payload: { transactionType, line } };
896
+ },
897
+ },
898
+ removeCreateTransactionLine: {
899
+ reducer(draft, action) {
900
+ const { transactionType, lineId } = action.payload;
901
+ const current = draft.createTransactionsState.newTransactionState[transactionType];
902
+ current.lines = current.lines.filter((line) => line.id !== lineId);
903
+ },
904
+ prepare(transactionType, lineId) {
905
+ return { payload: { transactionType, lineId } };
906
+ },
907
+ },
908
+ /**
909
+ * Restores the blank working copy AND re-seeds it, so reopening Create starts from a fresh
910
+ * form rather than the previous transaction's values.
911
+ */
912
+ resetCreateTransactionLocalData: {
913
+ reducer(draft, action) {
914
+ const { transactionType } = action.payload;
915
+ draft.createTransactionsState.newTransactionState[transactionType] =
916
+ getSeededCreateTransactionLocalData(transactionType);
917
+ draft.createTransactionsState.createStatus = {
918
+ fetchState: 'Not-Started',
919
+ };
920
+ draft.createTransactionsState.createdTransactionId = undefined;
921
+ },
922
+ prepare(transactionType) {
923
+ return { payload: { transactionType } };
924
+ },
925
+ },
926
+ /** Submit trigger -- createTransactionEpic builds the payload from localData. */
927
+ createTransaction: {
928
+ reducer(draft,
929
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
930
+ _action) {
931
+ draft.createTransactionsState.createStatus = {
932
+ fetchState: 'In-Progress',
933
+ };
934
+ draft.createTransactionsState.createdTransactionId = undefined;
935
+ },
936
+ prepare(transactionType) {
937
+ return { payload: { transactionType } };
938
+ },
939
+ },
940
+ /**
941
+ * Trigger only -- fetchVendorRecommendationsForCreateTransactionEpic does the work.
942
+ * A null entity means the vendor was cleared.
943
+ */
944
+ fetchVendorRecommendationsForCreateTransaction: {
945
+ reducer(
946
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
947
+ _draft,
948
+ // eslint-disable-next-line @typescript-eslint/no-unused-vars
949
+ _action) {
950
+ // no-op
951
+ },
952
+ prepare(transactionType, lineIds, entity) {
953
+ return { payload: { transactionType, lineIds, entity } };
954
+ },
955
+ },
956
+ /**
957
+ * Writes a vendor's recommendations into the named lines. `lineIds` is explicit rather than
958
+ * "all lines" because a journal entry recommends per line, from that line's own entity.
959
+ */
960
+ setRecommendationsForCreateTransactionLines: {
961
+ reducer(draft, action) {
962
+ const { transactionType, lineIds, recommendations, isAccountingClassesEnabled, } = action.payload;
963
+ const current = draft.createTransactionsState.newTransactionState[transactionType];
964
+ current.lines = current.lines.map((line) => lineIds.includes(line.id)
965
+ ? applyRecommendationsToCreateTransactionLine(line, recommendations, isAccountingClassesEnabled)
966
+ : line);
967
+ },
968
+ prepare(transactionType, lineIds, recommendations, isAccountingClassesEnabled) {
969
+ return {
970
+ payload: {
971
+ transactionType,
972
+ lineIds,
973
+ recommendations,
974
+ isAccountingClassesEnabled,
975
+ },
976
+ };
977
+ },
978
+ },
979
+ /** Vendor cleared: drop the dropdown group and undo only what the prefill wrote. */
980
+ clearRecommendationsForCreateTransactionLines: {
981
+ reducer(draft, action) {
982
+ const { transactionType, lineIds } = action.payload;
983
+ const current = draft.createTransactionsState.newTransactionState[transactionType];
984
+ current.lines = current.lines.map((line) => lineIds.includes(line.id)
985
+ ? clearRecommendationsFromCreateTransactionLine(line)
986
+ : line);
987
+ },
988
+ prepare(transactionType, lineIds) {
989
+ return { payload: { transactionType, lineIds } };
990
+ },
991
+ },
992
+ createTransactionSuccessOrFailure: {
993
+ reducer(draft, action) {
994
+ const { fetchState, error, createdTransactionId } = action.payload;
995
+ draft.createTransactionsState.createStatus = { fetchState, error };
996
+ if (createdTransactionId != null) {
997
+ draft.createTransactionsState.createdTransactionId =
998
+ createdTransactionId;
999
+ }
1000
+ },
1001
+ prepare(fetchState, createdTransactionId, error) {
1002
+ return { payload: { fetchState, createdTransactionId, error } };
1003
+ },
1004
+ },
832
1005
  },
833
1006
  extraReducers: (builder) => {
834
1007
  builder.addCase(clearAll, (draft) => {
@@ -836,7 +1009,7 @@ const transactionDetail = createSlice({
836
1009
  });
837
1010
  },
838
1011
  });
839
- export const { downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentSuccess, downloadAccountingProviderAttachmentFailure, fetchTransactionDetail, updateTransactionDetailFetchState, removeTransactionDetail, uploadMissingAttachmentSuccess, updateTransactionDetail, updateTransactionDetailSaveStatus, clearTransactionDetailSaveStatus, markTransactionAsNotMiscategorized, deleteTransactionAttachment, deleteTransactionAttachmentFailure, deleteTransactionAttachmentSuccess, updateStatusForTransactionNotMiscategorizedUpdate, updateStatusConsolidatedSaveTransactionDetail, updateTransactionStateIfUpdateActionNotAllowed, saveTransactionDetail, initializeTransactionDetailLocalData, saveTransactionDetailLocalData, clearTransactionDetailLocalData, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setEntityRecommendationForLineIdsForTransactionDetail, markCategoryClassRecommendationsInProgressForTransactionDetail, markCategoryClassRecommendationsCompletedForTransactionDetail, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetVendor, resetSelectedCustomer, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, addSplitLine, deleteSplitLine, toggleSplitEditMode, } = transactionDetail.actions;
1012
+ export const { downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentSuccess, downloadAccountingProviderAttachmentFailure, fetchTransactionDetail, updateTransactionDetailFetchState, removeTransactionDetail, uploadMissingAttachmentSuccess, updateTransactionDetail, updateTransactionDetailSaveStatus, clearTransactionDetailSaveStatus, markTransactionAsNotMiscategorized, deleteTransactionAttachment, deleteTransactionAttachmentFailure, deleteTransactionAttachmentSuccess, updateStatusForTransactionNotMiscategorizedUpdate, updateStatusConsolidatedSaveTransactionDetail, updateTransactionStateIfUpdateActionNotAllowed, saveTransactionDetail, initializeTransactionDetailLocalData, saveTransactionDetailLocalData, clearTransactionDetailLocalData, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setEntityRecommendationForLineIdsForTransactionDetail, markCategoryClassRecommendationsInProgressForTransactionDetail, markCategoryClassRecommendationsCompletedForTransactionDetail, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetVendor, resetSelectedCustomer, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, addSplitLine, deleteSplitLine, toggleSplitEditMode, initializeCreateTransactionLocalData, updateCreateTransactionLocalData, updateCreateTransactionLineLocalData, addCreateTransactionLine, removeCreateTransactionLine, resetCreateTransactionLocalData, createTransaction, createTransactionSuccessOrFailure, setRecommendationsForCreateTransactionLines, clearRecommendationsForCreateTransactionLines, fetchVendorRecommendationsForCreateTransaction, } = transactionDetail.actions;
840
1013
  export default transactionDetail.reducer;
841
1014
  function getUpdatedEntityLocalData(detail, updates, entity, resetRecommendations, type) {
842
1015
  const key = type === 'customer' ? 'customerUpdates' : 'vendorUpdates';
package/lib/index.d.ts CHANGED
@@ -643,8 +643,11 @@ import { TopExAccount, TopExReport, TopExTimePeriodWithMetaData, TopExpenses } f
643
643
  import { TOP_EX_TIME_PERIODS, TopExTimePeriod, TopExpense } from './view/topEx/topExState';
644
644
  import { AccountingProviderAttachmentSelector, getAccountingProviderAttachment } from './view/transactionDetail/getAccountingProviderAttachmentSelector';
645
645
  import { JOURNAL_ENTRY_SORT_KEYS, JournalEntryRowSortConfig, JournalEntrySortAccessors, JournalEntrySortKey, filterJournalEntryLinesExcludingLinked, journalEntryDefaultSortConfig, journalEntrySplitReconciliation, journalEntryTotalsByPostingSide, sortJournalEntryLines, sumJournalEntryAmounts, toJournalEntrySortKey } from './view/transactionDetail/journalEntryLinesViewModel';
646
+ import { CreateTransactionRequest, prepareCreateTransactionPayload } from './view/transactionDetail/createTransaction/createTransactionPayload';
647
+ import { CreateTransactionView, getCreateTransactionLocalData, getCreateTransactionStatus, getCreateTransactionVendorRecommendations, getCreateTransactionView } from './view/transactionDetail/createTransaction/createTransactionSelector';
648
+ import { ALL_CREATABLE_TRANSACTION_TYPES, CreatableTransactionType, CreateTransactionLineLocalData, CreateTransactionLocalData, RemitToAddress } from './view/transactionDetail/createTransaction/createTransactionState';
646
649
  import { getChangedLineItemCountFromLocalData, isAccountUncategorized } from './view/transactionDetail/transactionDetailLocalDataHelper';
647
- import { addSplitLine, clearTransactionDetailSaveStatus, deleteSplitLine, deleteTransactionAttachment, downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentFailure, downloadAccountingProviderAttachmentSuccess, fetchTransactionDetail, initializeTransactionDetailLocalData, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, resetAllLineItemsToVendor, resetLineItemsCategoryClassInLocalData, resetSelectedCustomer, resetVendor, saveTransactionDetail, saveTransactionDetailLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setAllLineItemsToCategoryClassInLocalData, setIsVendorUpdateAllChecked, toggleSplitEditMode, updateLatestSelectedEntity, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateSelectedCustomer, updateSelectedVendor, updateTransactionDetail, updateVendorBulkRecommendationsFetchStatus, updateVendorToAllLineItems, uploadMissingAttachmentSuccess } from './view/transactionDetail/transactionDetailReducer';
650
+ import { addCreateTransactionLine, addSplitLine, clearRecommendationsForCreateTransactionLines, clearTransactionDetailSaveStatus, createTransaction, createTransactionSuccessOrFailure, fetchVendorRecommendationsForCreateTransaction, initializeCreateTransactionLocalData, removeCreateTransactionLine, resetCreateTransactionLocalData, setRecommendationsForCreateTransactionLines, updateCreateTransactionLineLocalData, updateCreateTransactionLocalData, deleteSplitLine, deleteTransactionAttachment, downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentFailure, downloadAccountingProviderAttachmentSuccess, fetchTransactionDetail, initializeTransactionDetailLocalData, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, resetAllLineItemsToVendor, resetLineItemsCategoryClassInLocalData, resetSelectedCustomer, resetVendor, saveTransactionDetail, saveTransactionDetailLocalData, setAllLineItemsLocalDataIsUpdateAllChecked, setAllLineItemsToCategoryClassInLocalData, setIsVendorUpdateAllChecked, toggleSplitEditMode, updateLatestSelectedEntity, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateSelectedCustomer, updateSelectedVendor, updateTransactionDetail, updateVendorBulkRecommendationsFetchStatus, updateVendorToAllLineItems, uploadMissingAttachmentSuccess } from './view/transactionDetail/transactionDetailReducer';
648
651
  import { TransactionDetailReport, VendorDetailsView, getInitialUpdatablePeriodsForTransactionRecommendations, getTransactionDetail, getTransactionDetailForTransaction } from './view/transactionDetail/transactionDetailSelector';
649
652
  import { TransactionUpdates, getThirdPartyIdFromTransactionId } from './view/transactionDetail/transactionDetailState';
650
653
  import { TransactionDetailLineItemData, TransactionDetailLocalData, TransactionVendorUpdates } from './view/transactionDetail/transactionDetailTypes';
@@ -809,7 +812,7 @@ export { MatchedTransaction };
809
812
  export { SupportedTransaction, SupportedTransactionWithCOT, SupportedTransactionPayload, getScheduleTransactionById, getSupportedTransactionById, };
810
813
  export { updateLatestTransactionId, parallelFetchAccountTransactionList, parallelFetchEntityTransactionList, fetchAccountTransactionList, updateTransactionListByAccount, updateTransactionListByAccountFailure, updateTransactionListByAccountUIState, parallelFetchClassTransactionList, updateTransactionListByClassUIState, updateTransactionListByClass, parallelFetchProjectTransactionList, updateTransactionListByProjectUIState, updateTransactionListByProject, updateTransactionListUIStateByCategoryType, parallelFetchTransactionListByCategoryType, };
811
814
  export { TransactionListByAccountReport, getTransactionListByAccount, getTransactionListUIStateByAccountKey, };
812
- export { fetchEntityTransactionList, updateTransactionListByEntity, saveTransactionDetailLocalData, clearTransactionDetailSaveStatus, updateTransactionListByEntityFailure, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, saveTransactionDetail, setAllLineItemsLocalDataIsUpdateAllChecked, initializeTransactionDetailLocalData, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetSelectedCustomer, resetVendor, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, addSplitLine, deleteSplitLine, toggleSplitEditMode, };
815
+ export { ALL_CREATABLE_TRANSACTION_TYPES, initializeCreateTransactionLocalData, updateCreateTransactionLocalData, updateCreateTransactionLineLocalData, addCreateTransactionLine, removeCreateTransactionLine, resetCreateTransactionLocalData, createTransaction, createTransactionSuccessOrFailure, fetchVendorRecommendationsForCreateTransaction, setRecommendationsForCreateTransactionLines, clearRecommendationsForCreateTransactionLines, getCreateTransactionView, getCreateTransactionLocalData, getCreateTransactionStatus, getCreateTransactionVendorRecommendations, prepareCreateTransactionPayload, fetchEntityTransactionList, updateTransactionListByEntity, saveTransactionDetailLocalData, clearTransactionDetailSaveStatus, updateTransactionListByEntityFailure, resetLineItemsCategoryClassInLocalData, setAllLineItemsToCategoryClassInLocalData, saveTransactionDetail, setAllLineItemsLocalDataIsUpdateAllChecked, initializeTransactionDetailLocalData, markCategoryClassRecommendationsFailureForTransactionDetail, removeEntityRecommendationForLineIdForTransactionDetail, updateSelectedVendor, updateSelectedCustomer, resetSelectedCustomer, resetVendor, updateLocalDataWithTransactionsUpdateWithVendorCheckbox, updateVendorToAllLineItems, resetAllLineItemsToVendor, updateLatestSelectedEntity, updateVendorBulkRecommendationsFetchStatus, setIsVendorUpdateAllChecked, addSplitLine, deleteSplitLine, toggleSplitEditMode, };
813
816
  export { TransactionUpdates, downloadAccountingProviderAttachment, downloadAccountingProviderAttachmentSuccess, downloadAccountingProviderAttachmentFailure, fetchTransactionDetail, updateTransactionDetail, uploadMissingAttachmentSuccess, deleteTransactionAttachment, getThirdPartyIdFromTransactionId, };
814
817
  export { TransactionListByEntityView, getTransactionListByEntity };
815
818
  export { TransactionListByClassReport, getTransactionListByClass, getTransactionListUIStateByClassKey, TransactionListByProjectReport, getTransactionListByProject, getTransactionListUIStateByProjectKey, getTransactionListByEntityForSinglePeriod, };
@@ -908,6 +911,7 @@ export { CustomerSatisfactionInfo };
908
911
  export { fetchCompanyOnboardingView, fetchQBOConnectionPool, updateQBOConnectionPoolExternalConnection, fetchOnboardingCompletedCompanies, saveOnboardingCustomerCompletedStatus, ProductType, ProductGroupType, toProductType, toProductTypeStrict, ProductInfo, getOnboardingCockpitView, getNewOnboardingCustomerView, getOnboardingEmailGroup, initializeOnboardingCustomerViewUpdateData, clearOnboardingCustomerViewUpdateData, saveOnboardingCustomerViewUpdateData, updateOnboardingCustomerListUIState, updateCustomerCreationStatus, updateStatusAfterOnboardingCompleted, saveOnboardingCustomerViewUpdates, saveOnboardingCustomerNotes, saveOnboardingCustomerDataInLocalStore, updateOnboardingCustomerDataInLocalStore, NewOnboardingCustomer, OnboardingCustomer, OnboardingCockpitView, NewOnboardingCustomerView, NewOnboardingCustomerLocalData, OnboardingCustomerCompletedStatus, OnboardingCustomerListUIState, QBOConnectionPool, CustomerCreationStatus, OnboardingCompanyDetails, resetNewOnboardedCustomerId, sendOnboardingCustomerViewInvite, retryBankAccountConnectionForOnboarding, };
909
912
  export { TransactionListByCategoryType, getTransactionsListByCategoryType, getTransactionListUIStateByCategoryType, TransactionCategoryType, };
910
913
  export { TransactionDetailLocalData, TransactionDetailLineItemData, TransactionVendorUpdates, };
914
+ export { CreatableTransactionType, CreateTransactionLocalData, CreateTransactionLineLocalData, CreateTransactionView, CreateTransactionRequest, RemitToAddress, };
911
915
  export { getChangedLineItemCountFromLocalData, isAccountUncategorized };
912
916
  export { JOURNAL_ENTRY_SORT_KEYS, filterJournalEntryLinesExcludingLinked, journalEntryDefaultSortConfig, journalEntryTotalsByPostingSide, journalEntrySplitReconciliation, sortJournalEntryLines, sumJournalEntryAmounts, toJournalEntrySortKey, };
913
917
  export type { JournalEntryRowSortConfig, JournalEntrySortAccessors, JournalEntrySortKey, };