---
name: rate_limiter_new
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func RateLimiterNew(rate float64, burst int) *RateLimiter"
description: "Crea un RateLimiter token-bucket in-memory vacio. rate son los tokens recargados por segundo, burst es la capacidad maxima del bucket. Valores <= 0 se sustituyen por 1 como minimo seguro."
tags: [rate_limit, http, middleware, token_bucket, infra]
uses_functions: []
uses_types: [RateLimiter_go_infra]
returns: [RateLimiter_go_infra]
returns_optional: false
error_type: "error_go_core"
imports: []
params:
  - name: rate
    desc: "tokens recargados por segundo (tasa sostenida, ej: 10 = 10 req/s)"
  - name: burst
    desc: "capacidad maxima del bucket (rafaga maxima permitida en un instante, ej: 20)"
output: "puntero a RateLimiter inicializado con mapa vacio de clientes, listo para usar con RateLimiterCheck"
tested: true
tests: ["crea limiter con rate y burst configurados", "valores cero se sustituyen por 1", "el mapa de clientes empieza vacio"]
test_file_path: "functions/infra/rate_limiter_new_test.go"
file_path: "functions/infra/rate_limiter_new.go"
---

## Ejemplo

```go
// 10 req/s sostenidos, hasta 20 en rafaga
rl := RateLimiterNew(10, 20)

// 1 req/s, sin rafaga
strict := RateLimiterNew(1, 1)
```

## Notas

Funcion impura porque retorna un valor con estado mutable (mapa interno). No hace I/O ni network. La validacion de rate y burst evita panics por configuracion invalida (division por cero, buckets imposibles). Para iniciar el GC de entries inactivas usar `RateLimiterCleanup`.
