Function Semaphore

Semaphore(
    maxConcurrent: number,
): <This, Args extends unknown[], Return>(
    target: (this: This, ...args: Args) => Promise<Return>,
    context: ClassMethodDecoratorContext<
        This,
        (this: This, ...args: Args) => Promise<Return>,
    >,
) => (this: This, ...args: Args) => Promise<Return>
Limita a maxConcurrent las ejecuciones simultáneas del método asíncrono en la misma instancia (patrón Bulkhead); las llamadas que exceden el límite esperan en cola FIFO. Generaliza @Mutex (que equivale a Semaphore(1)). Un fallo libera el hueco con normalidad.
Parameters
- maxConcurrent: number
Returns <This, Args extends unknown[], Return>(
    target: (this: This, ...args: Args) => Promise<Return>,
    context: ClassMethodDecoratorContext<
        This,
        (this: This, ...args: Args) => Promise<Return>,
    >,
) => (this: This, ...args: Args) => Promise<Return>
Example
```
class Downloader {
  @Semaphore(3) // máximo 3 descargas a la vez
  async download(url: string): Promise<Blob> { ... }
}
```
- Defined in src/patterns/utility/semaphore.ts:18