32 lines
1.1 KiB
TypeScript
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);
|
|
}
|
|
}
|