@zeniai/client-epic-state 5.2.91 → 5.2.93-betaNB1

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

@@ -39,7 +39,7 @@ export declare const getLineItemsByTransactionsIdsFromResponse: (transactions: S
 export declare const getLineItemsByTransactionIdsFromLocalData: (transactionLocalData: TransactionReviewLocalDataSelectorView[], selectedTab: TransactionsTab) => Record<ID, string[]>;
 export declare const mergeTabSpecificLineItems: (currentTabSpecificLineItems: TabSpecificLineItems, selectedTab: TransactionsTab, newLineItems: TabSpecificLineItems) => TabSpecificLineItems;
 export declare const getSnackbarMessageForTransactionReview: (updatedCount: number, failedCount: number, categorizedCount: number) => {
-    messageSection: "common" | "recommendation_feedback" | "transactionDetails_updatingPastTransactions" | "transactionDetails_transactionUpdated" | "cockpit_month_end_email_sent" | "cockpit_month_end_email_save" | "cockpit_month_end_email_attachment_upload" | "je_bill_link" | "je_posted" | "actual_matching_match_and_reverse" | "actual_matching_undo_reversal" | "actual_matching_ignore_suggestion" | "audit_score_updated" | "people_invite_people" | "people_invite_multiple_people" | "people_delete_person" | "people_update_person" | "reimbursement_updated" | "reimbursement_deleted" | "reimbursement_cancelled_deleted" | "reimbursement_cancelled" | "reimbursement_approved" | "reimbursement_rejected" | "reimbursement_sent_for_approval" | "account_added" | "business_verification_save" | "business_verification_submit" | "business_verification_from_bills_submit" | "plaid_connection" | "unlink_deposit_account" | "reimbursement_setup" | "reimbursement_approval_create" | "reimbursement_duplicate_approval_create" | "reimbursement_approval_update" | "reimbursement_duplicate_approval_update" | "reimbursement_approval_delete" | "reimbursement_approval_reorder" | "reimbursement_create_mileage" | "reimbursement_update_mileage" | "reimbursement_accept_term" | "reimbursement_accept_employee_term" | "reimbursement_bulk_submit" | "reimbursement_bulk_processed" | "bill_pay_setup" | "zeni_accounts_setup" | "bill_pay_approval_create" | "bill_pay_duplicate_approval_create" | "bill_pay_approval_update" | "bill_pay_duplicate_approval_update" | "bill_pay_approval_delete" | "bill_pay_approval_reorder" | "bill_pay_updated" | "bill_pay_deleted" | "bill_pay_cancelled_deleted" | "bill_pay_cancelled" | "bill_pay_approved" | "real_time_approver_added" | "bill_pay_rejected" | "bill_pay_sent_for_approval" | "bill_pay_accept_term" | "bill_pay_bulk_submit" | "bill_pay_bulk_processed" | "bill_pay_refund" | "bill_pay_retry" | "bill_pay_marked_as_paid" | "zeni_account_accept_term" | "update_vendor" | "data_refresh_update" | "delete_bank_account" | "create_bank_account" | "create_bank_account_ach" | "create_bank_account_wire" | "create_bank_account_international" | "transfer_money" | "update_zeni_account_nickname" | "create_checking_account" | "deposit_check" | "create_vendor" | "onboarding_customer_view" | "onboarding_customer_view_complete" | "onboarding_customer_identity_verification_save" | "onboarding_customer_identity_verification_submit" | "onboarding_customer_business_verification_save" | "onboarding_customer_business_verification_submit" | "retry_bank_account_connection" | "dashboard_invite_sent" | "onboarding_info_saved" | "approve_original_merchant" | "approve_global_merchant" | "reject_global_merchant" | "create_global_merchant" | "fetch_global_merchant_no_recommendation" | "save_vendor_renamed" | "save_vendor_sent_for_review" | "save_vendor_marked_as_employee" | "save_vendor_marked_as_local_contractor" | "charge_card_setup" | "charge_card_accept_term" | "charge_card_receipt_upload" | "charge_card_resend_invite" | "charge_card_revoke_invite" | "card_policy_created" | "card_policy_updated" | "card_policy_deleted" | "charge_card_update_limit" | "charge_cards_update_limit" | "close_charge_card" | "lock_charge_card" | "lock_charge_card_card_user" | "lock_charge_cards" | "unlock_charge_card" | "unlock_charge_card_card_user" | "unlock_charge_cards" | "close_charge_cards" | "revoke_invite_charge_cards" | "charge_card_express_interest" | "create_schedule" | "save_schedule" | "delete_schedule" | "ignore_schedule" | "revert_schedule" | "ignore_accrual" | "revert_accrual" | "save_task_detail" | "fetch_task_detail" | "delete_task" | "archive_task" | "snooze_task" | "unsnooze_task" | "create_tag" | "delete_tag" | "update_charge_card" | "update_charge_card_name" | "update_charge_card_name_card_user" | "issue_charge_card" | "issue_charge_cards" | "notification_settings_saved" | "referral_invite_sent" | "notification_mark_as_read" | "mark_as_complete_schedule" | "cancel_journal_entry" | "settings_accounting_accounts_updated" | "create_card_setup" | "confirm_card_setup" | "add_card_payment_source" | "fetch_payment_sources" | "task_assigned_toast_notification" | "task_due_tomorrow_toast_notification" | "task_deleted_toast_notification" | "task_archived_toast_notification" | "task_overdue_toast_notification" | "task_overdue_toast_notification_creator" | "task_notification_count" | "task_activities_toast_notification" | "task_created_toast_notification" | "task_group_creation_success" | "task_group_deletion_success" | "task_group_update_success" | "primary_funding_account_updated" | "task_time_spent_validation" | "missing_receipts_attachment" | "flux_analysis_unreviewed" | "flux_analysis_reviewed" | "receipt_match" | "receipts_upload" | "receipts_bulk_match" | "billing_address_view" | "express_pay_submit" | "exclude_transaction" | "reconcile" | "save_reconcile_for_later" | "recon_transaction_categorize" | "recon_transaction_match" | "update_debit_card_pin_attempt" | "set_debit_card_pin" | "ai_cfo_create_session_and_submit" | "ai_cfo_chat_session_deleted" | "charge_card_auto_pay_enable" | "charge_card_auto_pay_disable" | "treasury_setup" | "treasury_accept_term" | "treasury_transfer_money" | "treasury_transfer_money_failed" | "auto_transfer_rule_create" | "auto_transfer_rule_update" | "auto_transfer_rule_delete" | "auto_transfer_rule_pause" | "auto_transfer_rule_resume" | "treasury_update_portfolio_allocation" | "send_email_magic_link_to_user" | "complete_profile_done" | "create_transfer_entry" | "reports_resync" | "invalid_phone_number" | "transactions_categorized_updated_failed" | "transaction_categorized_updated_failed" | "transactionsCategorized_transactionsUpdated" | "transactionsCategorized_transactionUpdated" | "transactionCategorized_transactionsUpdated" | "transactionCategorized_transactionUpdated" | "transactionsCategorized_transactionsFailed" | "transactionsCategorized_transactionFailed" | "transactionCategorized_transactionsFailed" | "transactionCategorized_transactionFailed" | "transactionsUpdated_transactionsFailed" | "transactionsUpdated_transactionFailed" | "transactionUpdated_transactionsFailed" | "transactionUpdated_transactionFailed" | "transactionsCategorized_transactionsUpdated_transactionsFailed" | "transactionsCategorized_transactionsUpdated_transactionFailed" | "transactionsCategorized_transactionUpdated_transactionsFailed" | "transactionCategorized_transactionsUpdated_transactionsFailed" | "transactionsCategorized_transactionUpdated_transactionFailed" | "transactionCategorized_transactionsUpdated_transactionFailed" | "transactionCategorized_transactionUpdated_transactionsFailed" | "transactionCategorized_transactionUpdated_transactionFailed" | "accounting_classes_enabled_update" | "accounting_projects_enabled_update" | "accounting_projects_qbo_not_enabled" | "capitalization_threshold_update" | "account_excluded_from_reconciliation" | "account_included_in_reconciliation" | "confirm_statement_mapping" | "statement_parsing_in_progress" | "statement_parsing_complete" | "ai_accountant_trigger_job" | "oauth_consent_approve" | "oauth_consent_invalid_request" | "credit_agent_update_profile" | "credit_agent_save_macro" | "credit_agent_schedule_cron" | "create_sub_task" | "qbo_connection_already_linked" | "qbo_connection_failed" | "accounting_projects_qbo_reconnect_failed" | "product_services_update" | "qbo_realm_id_update" | "kyc_kyb_reset" | "invoicing_dunning_case_resolved" | "invoicing_dunning_retry" | "invoicing_dunning_cancel" | "invoicing_dunning_settings_save" | "invoicing_qbo_backfill" | "invoicing_qbo_sync_health_retry" | "invoicing_qbo_settings_save" | "invoicing_branding_save" | "invoicing_discount_archive" | "invoicing_discount_unarchive" | "invoicing_discount_delete" | "invoicing_invoice_reminder_sent" | "invoicing_invoice_regenerated" | "invoicing_invoice_voided" | "invoicing_catalog_item_saved" | "invoicing_customer_saved" | "invoicing_subscription_saved" | "invoicing_coupon_saved" | "invoicing_invoice_saved" | "invoicing_credit_note_saved" | "invoicing_payment_recorded" | "invoicing_subscription_activated" | "invoicing_subscription_cancellation_removed" | "invoicing_subscription_cancelled" | "invoicing_subscription_non_renewing" | "invoicing_subscription_paused" | "invoicing_subscription_reactivated" | "invoicing_subscription_resumed" | "invoicing_subscription_term_end_changed" | "invoicing_data_import_download";
+    messageSection: "common" | "recommendation_feedback" | "transactionDetails_updatingPastTransactions" | "transactionDetails_transactionUpdated" | "cockpit_month_end_email_sent" | "cockpit_month_end_email_save" | "cockpit_month_end_email_attachment_upload" | "je_bill_link" | "je_posted" | "actual_matching_match_and_reverse" | "actual_matching_undo_reversal" | "actual_matching_ignore_suggestion" | "audit_score_updated" | "people_invite_people" | "people_invite_multiple_people" | "people_delete_person" | "people_update_person" | "reimbursement_updated" | "reimbursement_deleted" | "reimbursement_cancelled_deleted" | "reimbursement_cancelled" | "reimbursement_approved" | "reimbursement_rejected" | "reimbursement_sent_for_approval" | "account_added" | "business_verification_save" | "business_verification_submit" | "business_verification_from_bills_submit" | "plaid_connection" | "unlink_deposit_account" | "reimbursement_setup" | "reimbursement_approval_create" | "reimbursement_duplicate_approval_create" | "reimbursement_approval_update" | "reimbursement_duplicate_approval_update" | "reimbursement_approval_delete" | "reimbursement_approval_reorder" | "reimbursement_create_mileage" | "reimbursement_update_mileage" | "reimbursement_accept_term" | "reimbursement_accept_employee_term" | "reimbursement_bulk_submit" | "reimbursement_bulk_processed" | "bill_pay_setup" | "zeni_accounts_setup" | "bill_pay_approval_create" | "bill_pay_duplicate_approval_create" | "bill_pay_approval_update" | "bill_pay_duplicate_approval_update" | "bill_pay_approval_delete" | "bill_pay_approval_reorder" | "bill_pay_updated" | "bill_pay_deleted" | "bill_pay_cancelled_deleted" | "bill_pay_cancelled" | "bill_pay_approved" | "real_time_approver_added" | "bill_pay_rejected" | "bill_pay_sent_for_approval" | "bill_pay_accept_term" | "bill_pay_bulk_submit" | "bill_pay_bulk_processed" | "bill_pay_refund" | "bill_pay_retry" | "bill_pay_marked_as_paid" | "zeni_account_accept_term" | "update_vendor" | "data_refresh_update" | "delete_bank_account" | "create_bank_account" | "create_bank_account_ach" | "create_bank_account_wire" | "create_bank_account_international" | "transfer_money" | "update_zeni_account_nickname" | "create_checking_account" | "deposit_check" | "create_vendor" | "onboarding_customer_view" | "onboarding_customer_view_complete" | "onboarding_customer_identity_verification_save" | "onboarding_customer_identity_verification_submit" | "onboarding_customer_business_verification_save" | "onboarding_customer_business_verification_submit" | "retry_bank_account_connection" | "dashboard_invite_sent" | "onboarding_info_saved" | "approve_original_merchant" | "approve_global_merchant" | "reject_global_merchant" | "create_global_merchant" | "fetch_global_merchant_no_recommendation" | "save_vendor_renamed" | "save_vendor_sent_for_review" | "save_vendor_marked_as_employee" | "save_vendor_marked_as_local_contractor" | "charge_card_setup" | "charge_card_accept_term" | "charge_card_receipt_upload" | "charge_card_resend_invite" | "charge_card_revoke_invite" | "card_policy_created" | "card_policy_updated" | "card_policy_deleted" | "charge_card_update_limit" | "charge_cards_update_limit" | "close_charge_card" | "lock_charge_card" | "lock_charge_card_card_user" | "lock_charge_cards" | "unlock_charge_card" | "unlock_charge_card_card_user" | "unlock_charge_cards" | "close_charge_cards" | "revoke_invite_charge_cards" | "charge_card_express_interest" | "create_schedule" | "save_schedule" | "delete_schedule" | "ignore_schedule" | "revert_schedule" | "ignore_accrual" | "revert_accrual" | "save_task_detail" | "fetch_task_detail" | "delete_task" | "archive_task" | "snooze_task" | "unsnooze_task" | "create_tag" | "delete_tag" | "update_charge_card" | "update_charge_card_name" | "update_charge_card_name_card_user" | "issue_charge_card" | "issue_charge_cards" | "notification_settings_saved" | "referral_invite_sent" | "notification_mark_as_read" | "mark_as_complete_schedule" | "cancel_journal_entry" | "settings_accounting_accounts_updated" | "create_card_setup" | "confirm_card_setup" | "add_card_payment_source" | "fetch_payment_sources" | "task_assigned_toast_notification" | "task_due_tomorrow_toast_notification" | "task_deleted_toast_notification" | "task_archived_toast_notification" | "task_overdue_toast_notification" | "task_overdue_toast_notification_creator" | "task_notification_count" | "task_activities_toast_notification" | "task_created_toast_notification" | "task_group_creation_success" | "task_group_deletion_success" | "task_group_update_success" | "primary_funding_account_updated" | "task_time_spent_validation" | "missing_receipts_attachment" | "flux_analysis_unreviewed" | "flux_analysis_reviewed" | "receipt_match" | "receipts_upload" | "receipts_bulk_match" | "billing_address_view" | "express_pay_submit" | "exclude_transaction" | "reconcile" | "save_reconcile_for_later" | "recon_transaction_categorize" | "recon_transaction_match" | "update_debit_card_pin_attempt" | "set_debit_card_pin" | "ai_cfo_create_session_and_submit" | "ai_cfo_chat_session_deleted" | "charge_card_auto_pay_enable" | "charge_card_auto_pay_disable" | "treasury_setup" | "treasury_accept_term" | "treasury_transfer_money" | "treasury_transfer_money_failed" | "auto_transfer_rule_create" | "auto_transfer_rule_update" | "auto_transfer_rule_delete" | "auto_transfer_rule_pause" | "auto_transfer_rule_resume" | "treasury_update_portfolio_allocation" | "send_email_magic_link_to_user" | "complete_profile_done" | "create_transfer_entry" | "create_transaction" | "reports_resync" | "invalid_phone_number" | "transactions_categorized_updated_failed" | "transaction_categorized_updated_failed" | "transactionsCategorized_transactionsUpdated" | "transactionsCategorized_transactionUpdated" | "transactionCategorized_transactionsUpdated" | "transactionCategorized_transactionUpdated" | "transactionsCategorized_transactionsFailed" | "transactionsCategorized_transactionFailed" | "transactionCategorized_transactionsFailed" | "transactionCategorized_transactionFailed" | "transactionsUpdated_transactionsFailed" | "transactionsUpdated_transactionFailed" | "transactionUpdated_transactionsFailed" | "transactionUpdated_transactionFailed" | "transactionsCategorized_transactionsUpdated_transactionsFailed" | "transactionsCategorized_transactionsUpdated_transactionFailed" | "transactionsCategorized_transactionUpdated_transactionsFailed" | "transactionCategorized_transactionsUpdated_transactionsFailed" | "transactionsCategorized_transactionUpdated_transactionFailed" | "transactionCategorized_transactionsUpdated_transactionFailed" | "transactionCategorized_transactionUpdated_transactionsFailed" | "transactionCategorized_transactionUpdated_transactionFailed" | "accounting_classes_enabled_update" | "accounting_projects_enabled_update" | "accounting_projects_qbo_not_enabled" | "capitalization_threshold_update" | "account_excluded_from_reconciliation" | "account_included_in_reconciliation" | "confirm_statement_mapping" | "statement_parsing_in_progress" | "statement_parsing_complete" | "ai_accountant_trigger_job" | "oauth_consent_approve" | "oauth_consent_invalid_request" | "credit_agent_update_profile" | "credit_agent_save_macro" | "credit_agent_schedule_cron" | "create_sub_task" | "qbo_connection_already_linked" | "qbo_connection_failed" | "accounting_projects_qbo_reconnect_failed" | "product_services_update" | "qbo_realm_id_update" | "kyc_kyb_reset" | "invoicing_dunning_case_resolved" | "invoicing_dunning_retry" | "invoicing_dunning_cancel" | "invoicing_dunning_settings_save" | "invoicing_qbo_backfill" | "invoicing_qbo_sync_health_retry" | "invoicing_qbo_settings_save" | "invoicing_branding_save" | "invoicing_discount_archive" | "invoicing_discount_unarchive" | "invoicing_discount_delete" | "invoicing_invoice_reminder_sent" | "invoicing_invoice_regenerated" | "invoicing_invoice_voided" | "invoicing_catalog_item_saved" | "invoicing_customer_saved" | "invoicing_subscription_saved" | "invoicing_coupon_saved" | "invoicing_invoice_saved" | "invoicing_credit_note_saved" | "invoicing_payment_recorded" | "invoicing_subscription_activated" | "invoicing_subscription_cancellation_removed" | "invoicing_subscription_cancelled" | "invoicing_subscription_non_renewing" | "invoicing_subscription_paused" | "invoicing_subscription_reactivated" | "invoicing_subscription_resumed" | "invoicing_subscription_term_end_changed" | "invoicing_data_import_download";
     messageText: "notification" | "failed" | "success";
     type: "error" | "success" | "info";
     variables: {

package/lib/view/invoicing/invoicingOverview/invoicingOverviewPayload.d.ts

@@ -18,6 +18,7 @@ export interface InvoicingMRRDataPointPayload {
     month: string;
     mrr: number;
     churned?: number;
+    contraction?: number;
     expansion?: number;
     month_num?: number;
     net?: number;
@@ -46,6 +47,11 @@ export interface InvoicingDashboardSummaryPayload {
         resumed: number;
         total_active: number;
         total_active_value: number;
+        /**
+         * Churned opening-cohort customers ÷ customers at month start, as a 0-100
+         * percent. Customer-scoped, unlike the subscription-scoped KPI churn rate.
+         */
+        customer_churn_rate?: number | null;
     };
     failed_payments: {
         amount: number;
@@ -60,6 +66,7 @@ export interface InvoicingDashboardSummaryPayload {
     };
     mrr_movement: {
         churned: number;
+        contraction: number;
         expansions: number;
         net_change: number;
         new_subscriptions: number;

package/lib/view/invoicing/invoicingOverview/invoicingOverviewPayload.js

@@ -23,6 +23,7 @@ const mapInvoicingMRRDataPointPayloadToState = (payload) => ({
     month: payload.month,
     mrr: (0, amount_1.toAmount)(payload.mrr, 'USD', '$'),
     churned: payload.churned,
+    contraction: payload.contraction,
     expansion: payload.expansion,
     monthNum: payload.month_num,
     net: payload.net,
@@ -49,6 +50,7 @@ exports.mapInvoicingPlanRevenuePointPayloadToState = mapInvoicingPlanRevenuePoin
 const mapInvoicingDashboardSummaryPayloadToState = (payload) => ({
     customerMovement: {
         churned: payload.customer_movement.churned,
+        customerChurnRate: payload.customer_movement.customer_churn_rate ?? undefined,
         netChange: payload.customer_movement.net_change,
         new: payload.customer_movement.new,
         paused: payload.customer_movement.paused,
@@ -70,6 +72,7 @@ const mapInvoicingDashboardSummaryPayloadToState = (payload) => ({
     },
     mrrMovement: {
         churned: payload.mrr_movement.churned,
+        contraction: payload.mrr_movement.contraction,
         expansions: payload.mrr_movement.expansions,
         netChange: payload.mrr_movement.net_change,
         newSubscriptions: payload.mrr_movement.new_subscriptions,

package/lib/view/invoicing/invoicingOverview/invoicingOverviewState.d.ts

@@ -22,6 +22,7 @@ export interface InvoicingMRRDataPoint {
     month: string;
     mrr: Amount;
     churned?: number;
+    contraction?: number;
     expansion?: number;
     monthNum?: number;
     net?: number;
@@ -50,6 +51,8 @@ export interface InvoicingDashboardSummary {
         resumed: number;
         totalActive: number;
         totalActiveValue: Amount;
+        /** 0-100 percent; absent from a backend that predates it. */
+        customerChurnRate?: number;
     };
     failedPayments: {
         amount: Amount;
@@ -64,6 +67,7 @@ export interface InvoicingDashboardSummary {
     };
     mrrMovement: {
         churned: number;
+        contraction: number;
         expansions: number;
         netChange: number;
         newSubscriptions: number;

package/lib/view/transactionDetail/createTransaction/createTransactionLocalDataHelper.d.ts

@@ -0,0 +1,56 @@
+import { Recommendation, RecommendationWithCOT } from '../../../commonStateTypes/recommendationBase';
+import { TransactionCategory } from '../../../entity/transaction/stateTypes/transactionType';
+import { CreatableTransactionType, CreateTransactionLineLocalData, CreateTransactionLocalData, CreateTransactionLocalDataByType } from './createTransactionState';
+export declare const nextCreateTransactionLineId: () => string;
+/** Test-only: makes line ids predictable from the start of each case. */
+export declare const resetCreateTransactionLineIdCounter: () => void;
+export declare const createEmptyCreateTransactionLine: (postingType?: TransactionCategory) => CreateTransactionLineLocalData;
+/**
+ * The lines a freshly-opened form starts with. A journal entry is invalid with fewer than one
+ * debit and one credit, so it opens with both rather than making the user add the second row.
+ * Transfer has no lines at all.
+ */
+export declare const getDefaultCreateTransactionLines: (transactionType: CreatableTransactionType) => CreateTransactionLineLocalData[];
+/**
+ * A blank working copy for one type. Note this does NOT seed the date -- the reducer's initial
+ * state has to stay a pure constant so `clearAll` restores something stable. The date is seeded
+ * by initializeCreateTransactionLocalDataEpic, which runs when the form opens.
+ */
+export declare const getEmptyCreateTransactionLocalData: (transactionType: CreatableTransactionType) => CreateTransactionLocalData;
+export declare const getInitialCreateTransactionLocalDataByType: () => CreateTransactionLocalDataByType;
+/**
+ * What the form opens with: a blank copy plus today's date, the default line set, and the
+ * payment_type the backend insists on for the type.
+ */
+export declare const getSeededCreateTransactionLocalData: (transactionType: CreatableTransactionType) => CreateTransactionLocalData;
+/**
+ * Merges a partial edit into the working copy. Lines are replaced wholesale when present --
+ * a partial line array would silently truncate the form.
+ */
+export declare const mergeCreateTransactionLocalData: (current: CreateTransactionLocalData, update: Partial<CreateTransactionLocalData>) => CreateTransactionLocalData;
+/**
+ * A user edit to a prefilled account or class makes it theirs, so its flag is dropped and a
+ * later vendor switch no longer clears it.
+ */
+export declare const updateCreateTransactionLine: (lines: CreateTransactionLineLocalData[], lineId: string, update: Partial<CreateTransactionLineLocalData>) => CreateTransactionLineLocalData[];
+/**
+ * Recommendation -> RecommendationWithCOT. Chain-of-thought and recommendation feedback both
+ * need an existing transaction, so cot/reasoning are empty here by design; the dropdown only
+ * needs the entities to build its "Recommended" group.
+ */
+export declare const toRecommendationsWithCOT: (recommendations: Recommendation[]) => RecommendationWithCOT[];
+/**
+ * Applies a vendor's recommendations to one line: always refreshes the dropdown's "Recommended"
+ * group, but only prefills account/class when the field is still empty. Callers switching
+ * vendors clear the previous prefill first, so "empty" includes what the last vendor filled. Anything the user
+ * picked wins -- this follows the transaction-categorization helper, which prefills, rather
+ * than the detail-page helper, which only suggests.
+ */
+export declare const applyRecommendationsToCreateTransactionLine: (line: CreateTransactionLineLocalData, recommendations: Recommendation[], isAccountingClassesEnabled: boolean) => CreateTransactionLineLocalData;
+/**
+ * Undoes a prefill when the vendor is cleared. Only the fields the prefill wrote are removed --
+ * the per-field flags are what make the user's own choices distinguishable from ours, which is
+ * why they are not a single line-level boolean: a hand-picked account alongside a prefilled
+ * class is an ordinary state, and clearing must not take the account with it.
+ */
+export declare const clearRecommendationsFromCreateTransactionLine: (line: CreateTransactionLineLocalData) => CreateTransactionLineLocalData;

package/lib/view/transactionDetail/createTransaction/createTransactionLocalDataHelper.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearRecommendationsFromCreateTransactionLine = exports.applyRecommendationsToCreateTransactionLine = exports.toRecommendationsWithCOT = exports.updateCreateTransactionLine = exports.mergeCreateTransactionLocalData = exports.getSeededCreateTransactionLocalData = exports.getInitialCreateTransactionLocalDataByType = exports.getEmptyCreateTransactionLocalData = exports.getDefaultCreateTransactionLines = exports.createEmptyCreateTransactionLine = exports.resetCreateTransactionLineIdCounter = exports.nextCreateTransactionLineId = void 0;
+const zeniDayJS_1 = require("../../../zeniDayJS");
+const createTransactionState_1 = require("./createTransactionState");
+/**
+ * Monotonic counter for line row keys. These never leave the client -- the payload builder
+ * drops them -- so a counter is enough, and it keeps reducer tests deterministic in a way
+ * randomUUID would not.
+ */
+let lineIdCounter = 0;
+const nextCreateTransactionLineId = () => `create-transaction-line-${lineIdCounter++}`;
+exports.nextCreateTransactionLineId = nextCreateTransactionLineId;
+/** Test-only: makes line ids predictable from the start of each case. */
+const resetCreateTransactionLineIdCounter = () => {
+    lineIdCounter = 0;
+};
+exports.resetCreateTransactionLineIdCounter = resetCreateTransactionLineIdCounter;
+const createEmptyCreateTransactionLine = (postingType) => ({
+    id: (0, exports.nextCreateTransactionLineId)(),
+    postingType,
+});
+exports.createEmptyCreateTransactionLine = createEmptyCreateTransactionLine;
+/**
+ * The lines a freshly-opened form starts with. A journal entry is invalid with fewer than one
+ * debit and one credit, so it opens with both rather than making the user add the second row.
+ * Transfer has no lines at all.
+ */
+const getDefaultCreateTransactionLines = (transactionType) => {
+    if (transactionType === 'transfer') {
+        return [];
+    }
+    if (transactionType === 'journal_entry') {
+        return [
+            (0, exports.createEmptyCreateTransactionLine)('debit'),
+            (0, exports.createEmptyCreateTransactionLine)('credit'),
+        ];
+    }
+    return [(0, exports.createEmptyCreateTransactionLine)()];
+};
+exports.getDefaultCreateTransactionLines = getDefaultCreateTransactionLines;
+/**
+ * A blank working copy for one type. Note this does NOT seed the date -- the reducer's initial
+ * state has to stay a pure constant so `clearAll` restores something stable. The date is seeded
+ * by initializeCreateTransactionLocalDataEpic, which runs when the form opens.
+ */
+const getEmptyCreateTransactionLocalData = (transactionType) => ({
+    lines: [],
+    transactionType,
+});
+exports.getEmptyCreateTransactionLocalData = getEmptyCreateTransactionLocalData;
+const getInitialCreateTransactionLocalDataByType = () => createTransactionState_1.ALL_CREATABLE_TRANSACTION_TYPES.reduce((acc, transactionType) => {
+    acc[transactionType] =
+        (0, exports.getEmptyCreateTransactionLocalData)(transactionType);
+    return acc;
+}, {});
+exports.getInitialCreateTransactionLocalDataByType = getInitialCreateTransactionLocalDataByType;
+/**
+ * The payment_type the backend insists on for some types: a check needs `check`, and a
+ * credit_card_credit (sent as expense + is_credit) needs a card type -- qbo_purchase.py raises
+ * without them.
+ */
+const SEEDED_PAYMENT_TYPE = {
+    check: 'check',
+    credit_card_credit: 'credit_card',
+};
+/**
+ * What the form opens with: a blank copy plus today's date, the default line set, and the
+ * payment_type the backend insists on for the type.
+ */
+const getSeededCreateTransactionLocalData = (transactionType) => ({
+    ...(0, exports.getEmptyCreateTransactionLocalData)(transactionType),
+    lines: (0, exports.getDefaultCreateTransactionLines)(transactionType),
+    paymentType: SEEDED_PAYMENT_TYPE[transactionType],
+    transactionDate: (0, zeniDayJS_1.dateNow)(),
+});
+exports.getSeededCreateTransactionLocalData = getSeededCreateTransactionLocalData;
+/**
+ * Merges a partial edit into the working copy. Lines are replaced wholesale when present --
+ * a partial line array would silently truncate the form.
+ */
+const mergeCreateTransactionLocalData = (current, update) => ({
+    ...current,
+    ...update,
+    lines: update.lines ?? current.lines,
+    // The type is keyed by the slice, never edited through a merge.
+    transactionType: current.transactionType,
+});
+exports.mergeCreateTransactionLocalData = mergeCreateTransactionLocalData;
+/**
+ * A user edit to a prefilled account or class makes it theirs, so its flag is dropped and a
+ * later vendor switch no longer clears it.
+ */
+const updateCreateTransactionLine = (lines, lineId, update) => lines.map((line) => line.id === lineId
+    ? {
+        ...line,
+        ...update,
+        id: line.id,
+        isAccountPreFilled: 'accountQboId' in update ? undefined : line.isAccountPreFilled,
+        isClassPreFilled: 'classId' in update ? undefined : line.isClassPreFilled,
+    }
+    : line);
+exports.updateCreateTransactionLine = updateCreateTransactionLine;
+/**
+ * Recommendation -> RecommendationWithCOT. Chain-of-thought and recommendation feedback both
+ * need an existing transaction, so cot/reasoning are empty here by design; the dropdown only
+ * needs the entities to build its "Recommended" group.
+ */
+const toRecommendationsWithCOT = (recommendations) => recommendations.map((recommendation) => ({
+    account: recommendation.account != null
+        ? { ...recommendation.account, cot: [], reasoning: '' }
+        : undefined,
+    class: recommendation.class != null
+        ? { ...recommendation.class, cot: [], reasoning: '' }
+        : undefined,
+    vendor: recommendation.vendor != null
+        ? { ...recommendation.vendor, cot: [], reasoning: '' }
+        : undefined,
+}));
+exports.toRecommendationsWithCOT = toRecommendationsWithCOT;
+/**
+ * Applies a vendor's recommendations to one line: always refreshes the dropdown's "Recommended"
+ * group, but only prefills account/class when the field is still empty. Callers switching
+ * vendors clear the previous prefill first, so "empty" includes what the last vendor filled. Anything the user
+ * picked wins -- this follows the transaction-categorization helper, which prefills, rather
+ * than the detail-page helper, which only suggests.
+ */
+const applyRecommendationsToCreateTransactionLine = (line, recommendations, isAccountingClassesEnabled) => {
+    const top = recommendations[0];
+    const updated = {
+        ...line,
+        recommendationsWithCOT: (0, exports.toRecommendationsWithCOT)(recommendations),
+    };
+    if (line.accountQboId == null && top?.account?.qboId != null) {
+        updated.accountQboId = top.account.qboId;
+        updated.accountName = top.account.accountName;
+        updated.isAccountPreFilled = true;
+    }
+    if (isAccountingClassesEnabled &&
+        line.classId == null &&
+        top?.class?.classId != null) {
+        updated.classId = top.class.classId;
+        updated.className = top.class.className;
+        updated.isClassPreFilled = true;
+    }
+    return updated;
+};
+exports.applyRecommendationsToCreateTransactionLine = applyRecommendationsToCreateTransactionLine;
+/**
+ * Undoes a prefill when the vendor is cleared. Only the fields the prefill wrote are removed --
+ * the per-field flags are what make the user's own choices distinguishable from ours, which is
+ * why they are not a single line-level boolean: a hand-picked account alongside a prefilled
+ * class is an ordinary state, and clearing must not take the account with it.
+ */
+const clearRecommendationsFromCreateTransactionLine = (line) => {
+    const cleared = {
+        ...line,
+        recommendationsWithCOT: undefined,
+    };
+    if (line.isAccountPreFilled === true) {
+        cleared.accountQboId = undefined;
+        cleared.accountName = undefined;
+        cleared.isAccountPreFilled = undefined;
+    }
+    if (line.isClassPreFilled === true) {
+        cleared.classId = undefined;
+        cleared.className = undefined;
+        cleared.isClassPreFilled = undefined;
+    }
+    return cleared;
+};
+exports.clearRecommendationsFromCreateTransactionLine = clearRecommendationsFromCreateTransactionLine;

package/lib/view/transactionDetail/createTransaction/createTransactionPayload.d.ts

@@ -0,0 +1,95 @@
+import { ID } from '../../../commonStateTypes/common';
+import { ProjectBasePayload } from '../../../entity/project/projectPayload';
+import { TransactionPayload } from '../../../entity/transaction/payloadTypes/transactionPayload';
+import { ZeniAPIResponse } from '../../../responsePayload';
+import { RootState } from '../../../rootStateTypes';
+import { CreateTransactionLocalData } from './createTransactionState';
+/**
+ * Wire types for POST /1.0/transactions/manage.
+ *
+ * Two things here are easy to get wrong and are deliberately explicit:
+ *
+ * 1. `line_detail_type` is snake_case. The PascalCase strings in the backend are Python
+ *    constant NAMES; ZENI_LINE_DETAIL_TYPE_TO_QBO_LINE_DETAIL_TYPE_MAP converts them for the
+ *    body the backend sends on to QuickBooks, never for ours.
+ * 2. The reference number uses two different keys depending on the QBO entity. check and
+ *    expense are Purchases and take `document_number`; everything else takes `document_id`.
+ */
+export interface CreateTransactionAccountPayload {
+    qbo_id: ID;
+    account_name?: string;
+}
+export interface CreateTransactionLineDetailPayload {
+    account?: CreateTransactionAccountPayload;
+    class?: Record<string, never> | {
+        qbo_id: ID;
+    };
+    /**
+     * journal_entry only, and it MUST sit inside line_detail. The write validator's docstring
+     * warns that a misplaced posting_type is silently dropped and then rejected by QBO.
+     */
+    posting_type?: 'credit' | 'debit';
+    /** Same shape the transaction update sends on a vendor line. */
+    project?: ProjectBasePayload;
+    vendor?: {
+        qbo_id: ID;
+    };
+}
+export interface CreateTransactionLinePayload {
+    amount: number;
+    line_detail: CreateTransactionLineDetailPayload;
+    line_detail_type: 'account_based_expense_line_detail' | 'item_based_expense_line_detail' | 'journal_entry_line_detail';
+    line_description?: string;
+}
+export interface CreateTransactionRemitToAddressPayload {
+    city?: string;
+    country?: string;
+    line1?: string;
+    postal_code?: string;
+    state?: string;
+}
+export interface CreateTransactionRequest extends Record<string, unknown> {
+    transaction_date: string;
+    transaction_type: string;
+    /** journal_entry reference number. */
+    document_id?: string;
+    /** check / credit_card_credit reference number (QBO Purchase). */
+    document_number?: string;
+    from_account_id?: ID;
+    /** credit_card_credit is modelled as a Purchase with Credit: true. */
+    is_credit?: boolean;
+    lines?: CreateTransactionLinePayload[];
+    payment_type?: string;
+    print_status?: string;
+    qbo_account_id?: ID;
+    remit_to_address?: CreateTransactionRemitToAddressPayload;
+    to_account_id?: ID;
+    total_amount?: number;
+    transaction_memo?: string;
+    vendor_id?: ID;
+}
+/**
+ * The create endpoint writes to QBO and returns the created entity; Zeni's own mirror is
+ * populated by the delta sync that runs afterwards, so this response is the only view of the
+ * new transaction the client gets immediately.
+ */
+export interface CreateTransactionPayload {
+    transactions: TransactionPayload[];
+}
+export type CreateTransactionResponse = ZeniAPIResponse<CreateTransactionPayload>;
+/**
+ * Thrown when a picked id has no QBO id to send. Sending the Zeni id instead would reach QBO as
+ * an unknown reference and come back as an opaque error, so the create is stopped here and the
+ * epic shows this message instead.
+ */
+export declare class UnresolvedCreateTransactionIdError extends Error {
+}
+/**
+ * Builds the request body for one transaction type. One branch per type rather than a shared
+ * body with optional keys, because the types genuinely diverge -- transfer carries no lines at
+ * all, and journal_entry carries no header account.
+ *
+ * Throws UnresolvedCreateTransactionIdError when a picked vendor (header or journal entry line),
+ * class or transfer account has no QBO id.
+ */
+export declare const prepareCreateTransactionPayload: (state: RootState, localData: CreateTransactionLocalData) => CreateTransactionRequest;

package/lib/view/transactionDetail/createTransaction/createTransactionPayload.js

@@ -0,0 +1,169 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareCreateTransactionPayload = exports.UnresolvedCreateTransactionIdError = void 0;
+const timePeriod_1 = require("../../../commonStateTypes/timePeriod");
+const accountSelector_1 = require("../../../entity/account/accountSelector");
+const classSelector_1 = require("../../../entity/class/classSelector");
+const projectPayload_1 = require("../../../entity/project/projectPayload");
+const projectSelector_1 = require("../../../entity/project/projectSelector");
+const vendorSelector_1 = require("../../../entity/vendor/vendorSelector");
+const toRemitToAddressPayload = (address) => {
+    if (address == null) {
+        return undefined;
+    }
+    return {
+        line1: address.line1,
+        city: address.city,
+        state: address.state,
+        postal_code: address.postalCode,
+        country: address.country,
+    };
+};
+const toLinePayload = (state, line, transactionType) => {
+    const lineDetail = {};
+    if (line.accountQboId != null) {
+        lineDetail.account = {
+            qbo_id: line.accountQboId,
+            account_name: line.accountName,
+        };
+    }
+    // An empty object is what the confirmed payloads send when no class is chosen; sending the
+    // key with a qbo_id only once one is picked.
+    const classQboId = toQboClassId(state, line.classId);
+    lineDetail.class = classQboId != null ? { qbo_id: classQboId } : {};
+    if (line.projectId != null) {
+        lineDetail.project = (0, projectPayload_1.toProjectBasePayload)((0, projectSelector_1.getProjectById)(state.projectState, line.projectId) ?? {
+            projectId: line.projectId,
+            projectName: '',
+        });
+    }
+    if (transactionType === 'journal_entry') {
+        lineDetail.posting_type = line.postingType;
+        const vendorQboId = toQboLineVendorId(state, line.vendorQboId);
+        if (vendorQboId != null) {
+            lineDetail.vendor = { qbo_id: vendorQboId };
+        }
+    }
+    return {
+        // The backend rejects a bool here, so this is always coerced to a number.
+        amount: line.amount?.amount ?? 0,
+        line_description: line.lineDescription,
+        line_detail_type: transactionType === 'journal_entry'
+            ? 'journal_entry_line_detail'
+            : 'account_based_expense_line_detail',
+        line_detail: lineDetail,
+    };
+};
+/**
+ * Thrown when a picked id has no QBO id to send. Sending the Zeni id instead would reach QBO as
+ * an unknown reference and come back as an opaque error, so the create is stopped here and the
+ * epic shows this message instead.
+ */
+class UnresolvedCreateTransactionIdError extends Error {
+}
+exports.UnresolvedCreateTransactionIdError = UnresolvedCreateTransactionIdError;
+/**
+ * Resolves a transfer account (the Zeni account id from the transfer pools) to its QBO id. The
+ * header and line account dropdowns already hold the QBO id, so they are sent as-is.
+ */
+const toQboTransferAccountId = (state, accountId) => {
+    if (accountId == null) {
+        return undefined;
+    }
+    const qboId = (0, accountSelector_1.getAccountBaseForTransferAccounts)(state.accountState, accountId)?.qboId;
+    if (qboId == null || qboId === '') {
+        throw new UnresolvedCreateTransactionIdError('The selected transfer account could not be found in QuickBooks.');
+    }
+    return qboId;
+};
+/** Resolves a Zeni class id (`class_<uuid>`) to the QBO id `line_detail.class.qbo_id` expects. */
+const toQboClassId = (state, classId) => {
+    if (classId == null) {
+        return undefined;
+    }
+    const qboId = (0, classSelector_1.getClassById)(state.classState, {
+        classId,
+        reportId: 'class_list',
+    })?.qboId;
+    if (qboId == null || qboId === '') {
+        throw new UnresolvedCreateTransactionIdError('The selected class could not be found in QuickBooks.');
+    }
+    return qboId;
+};
+/** A vendor not yet synced to QBO carries `qboId === name`, which QBO would reject. */
+const toSyncedVendorQboId = (vendor) => {
+    if (vendor == null || vendor.qboId === '' || vendor.qboId === vendor.name) {
+        throw new UnresolvedCreateTransactionIdError('The selected vendor is not synced to QuickBooks yet.');
+    }
+    return vendor.qboId;
+};
+/** Resolves a Zeni vendor id to its QBO id -- `vendor_id` on the wire is a QBO id. */
+const toQboVendorId = (state, vendorId) => vendorId == null
+    ? undefined
+    : toSyncedVendorQboId((0, vendorSelector_1.getVendorByVendorId)(state.vendorState, vendorId));
+/** A journal entry line holds the QBO id already, so it is only checked against the store. */
+const toQboLineVendorId = (state, vendorQboId) => vendorQboId == null
+    ? undefined
+    : toSyncedVendorQboId((0, vendorSelector_1.getVendorByQboId)(state.vendorState, vendorQboId));
+/**
+ * Builds the request body for one transaction type. One branch per type rather than a shared
+ * body with optional keys, because the types genuinely diverge -- transfer carries no lines at
+ * all, and journal_entry carries no header account.
+ *
+ * Throws UnresolvedCreateTransactionIdError when a picked vendor (header or journal entry line),
+ * class or transfer account has no QBO id.
+ */
+const prepareCreateTransactionPayload = (state, localData) => {
+    const { transactionType } = localData;
+    const base = {
+        transaction_type: transactionType,
+        transaction_date: localData.transactionDate?.format(timePeriod_1.DEFAULT_DATE_FORMAT) ?? '',
+        transaction_memo: localData.transactionMemo,
+    };
+    if (transactionType === 'transfer') {
+        return {
+            ...base,
+            from_account_id: toQboTransferAccountId(state, localData.fromAccountId),
+            to_account_id: toQboTransferAccountId(state, localData.toAccountId),
+            total_amount: localData.totalAmount?.amount ?? 0,
+        };
+    }
+    const lines = localData.lines.map((line) => toLinePayload(state, line, transactionType));
+    if (transactionType === 'journal_entry') {
+        return {
+            ...base,
+            document_id: localData.documentId,
+            lines,
+        };
+    }
+    const purchaseBase = {
+        ...base,
+        payment_type: localData.paymentType,
+        qbo_account_id: localData.qboAccountId,
+        vendor_id: toQboVendorId(state, localData.vendorId),
+        lines,
+    };
+    if (transactionType === 'check') {
+        return {
+            ...purchaseBase,
+            document_number: localData.documentNumber,
+            print_status: localData.printStatus,
+            remit_to_address: toRemitToAddressPayload(localData.remitToAddress),
+        };
+    }
+    if (transactionType === 'credit_card_credit') {
+        // credit_card_credit is not in the backend's SUPPORTED_TRANSACTION_WRITE_TYPES. QBO models
+        // it as a Purchase with Credit: true and qbo_purchase.py already honours is_credit for
+        // card payment types, so this sends `expense` + is_credit rather than a type the validator
+        // rejects outright. Confirm with backend before enabling the menu item. The seed sets
+        // payment_type to credit_card, since qbo_purchase.py raises on is_credit without a card type.
+        return {
+            ...purchaseBase,
+            transaction_type: 'expense',
+            is_credit: true,
+            document_number: localData.documentNumber,
+        };
+    }
+    return purchaseBase;
+};
+exports.prepareCreateTransactionPayload = prepareCreateTransactionPayload;