Files
clean-architecture-frontend…/src/platform/traffic/request-fanout.ts
T

32 lines
1.1 KiB
TypeScript

/**
* Spec §12 / §41. Collection cardinality must not become physical request
* cardinality. Loading N rows costs a bounded number of requests (one page or
* one bulk/read-model call), never one request per row.
*/
export class RequestFanoutExceededError extends RangeError {
readonly physicalRequests: number;
readonly maximum: number;
constructor(physicalRequests: number, maximum: number) {
super(`Request fan-out ${physicalRequests} exceeds ${maximum}`);
this.name = "RequestFanoutExceededError";
this.physicalRequests = physicalRequests;
this.maximum = maximum;
}
}
export function assertRequestFanoutWithinBudget(
physicalRequests: number,
maximum: number,
): void {
if (!Number.isSafeInteger(maximum) || maximum < 1) {
throw new TypeError(`Invalid request fan-out budget: ${maximum}`);
}
if (!Number.isSafeInteger(physicalRequests) || physicalRequests < 0) {
throw new TypeError(`Invalid physical request count: ${physicalRequests}`);
}
if (physicalRequests > maximum) {
throw new RequestFanoutExceededError(physicalRequests, maximum);
}
}