Function selectWeightedProvider

Select a single provider from a list using optional per-provider weights.

Selection rules:

• If providers is empty, throws an Error.
• If weights is undefined or providers has exactly one entry, the first provider is returned deterministically.
• Otherwise a weighted random selection is performed: each provider's weight is looked up in weights (defaulting to 1 for unlisted providers), weights are summed, and a random value in [0, sum) picks the winner proportionally.

Throws

When providers is empty.

Example

// 90% suno, 10% udio (approximately)
selectWeightedProvider(['suno', 'udio'], { suno: 9, udio: 1 });
Copy