@accounter/server
Version:
Accounter GraphQL server
39 lines (38 loc) • 1.5 kB
TypeScript
/**
* Queue Match Evaluator Provider
*
* Lazily evaluates match suggestions for a batch of unmatched charges, powering
* the charge matching review screen queue. Purely read-only and analytical —
* no DB mutations happen here.
*/
import type { ChargeMatchProto } from '../types.js';
import { ChargesMatcherProvider } from './charges-matcher.provider.js';
/**
* A base charge paired with its match suggestions, ordered by confidence score
* (highest first)
*/
export interface ChargeWithSuggestionsProto<TCharge = {
id: string;
}> {
id: string;
baseCharge: TCharge;
suggestions: ChargeMatchProto[];
}
export declare class QueueMatchEvaluatorProvider {
private chargesMatcherProvider;
constructor(chargesMatcherProvider: ChargesMatcherProvider);
/**
* Calculate match suggestions for a batch of unmatched charges on the fly.
*
* Delegates to `ChargesMatcherProvider.findMatchesForCharges`, which builds the
* candidate pool once for the whole batch (instead of once per charge). A charge
* whose evaluation fails (e.g. it turns out to be already matched) is returned
* with empty suggestions rather than failing the whole batch.
*
* @param baseCharges - Unmatched charges to evaluate, in queue order
* @returns One entry per input charge, preserving input order
*/
evaluateMatchesForCharges<TCharge extends {
id: string;
}>(baseCharges: TCharge[]): Promise<ChargeWithSuggestionsProto<TCharge>[]>;
}