games_app/backend/dist-test-faq/services/approvalPolicyEngine.d.ts

40 lines
2.1 KiB
TypeScript

/**
* Evaluates configurable approval policies (N-of-M / auto-execute).
*/
import type { ApprovalPolicyRow, PolicyDecision, QuorumSlot, WalletKind } from '../repositories/approvalPolicyRepository';
import type { FundOperationType } from '../repositories/fundOperationRequestRepository';
import type { FundOperationVoteRow } from '../repositories/fundOperationVoteRepository';
export type EvaluateInput = {
operationType: FundOperationType | string;
amountRaw?: string | null;
walletTypeId?: number | null;
network?: string | null;
sourceKind?: WalletKind;
destKind?: WalletKind;
};
export type EvaluateResult = {
policy: ApprovalPolicyRow | null;
decision: PolicyDecision;
matchedBy: 'policy' | 'fail_closed_default';
};
export declare function policyMatches(policy: ApprovalPolicyRow, input: EvaluateInput): boolean;
export declare function evaluate(input: EvaluateInput): Promise<EvaluateResult>;
/** True if approve votes satisfy every quorum slot. */
export declare function quorumSatisfied(quorum: QuorumSlot[], approveVotes: FundOperationVoteRow[], voterHasRole: (voterId: string, role: string) => boolean, voterHasPermission: (voterId: string, permission: string) => boolean): boolean;
/**
* Count how many approve votes fill each slot (role-based; permission slots need prefilter).
*/
export declare function countQuorumProgress(quorum: QuorumSlot[], approveVotes: FundOperationVoteRow[]): {
required: number;
approved: number;
slots: Array<{
slot: QuorumSlot;
filled: number;
needed: number;
}>;
};
export declare function isQuorumComplete(quorum: QuorumSlot[], approveVotes: FundOperationVoteRow[]): boolean;
/** Whether voter can contribute to any unfilled quorum slot. */
export declare function voterFillsOpenSlot(quorum: QuorumSlot[], approveVotes: FundOperationVoteRow[], voterRoles: string[], voterPermissions: string[]): boolean;
export declare function annotateVoterRolesForQuorum(roles: string[], permissions: string[], quorum: QuorumSlot[]): string[];
//# sourceMappingURL=approvalPolicyEngine.d.ts.map