Query - previewFinanceRevaluationRun

Prices the workspace's open foreign-currency balances at a date without persisting anything, so a revaluation can be reviewed before it exists. Prices every open foreign balance the subledgers hold — customer and vendor invoices, their contra sets credit memos and vendor credits, and unapplied receipt cash sitting in the customer-deposit liability. Shares the builder createFinanceRevaluationRun uses, so the preview is the run. Access: signed-in members of the workspace with finance report read access. Errors: no exchange rate is stored for a currency on or before the date; a document outside the customer-invoice set carries no usable record of the rate and home balance it posted at; an open balance is too small for the rate to carry into a whole base minor unit; a foreign remainder was never parked outside AR; or there is nothing to revalue — including the case where the only open foreign balances are receivables the run could not price, which is refused by its own sentence rather than reported as nothing to revalue. A receivable carrying no usable record is left out of the adjustment and named in unpricedDocuments instead of refusing.