fn_registry/functions/infra/rate_limiter_cleanup.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
rate_limiter_cleanup	function	go	infra	1.0.0	impure	func RateLimiterCleanup(rl *RateLimiter, maxAge time.Duration, interval time.Duration) func()	Arranca una goroutine que purga periodicamente las entries del RateLimiter sin actividad reciente. Retorna una funcion para detener el GC sin leaks de goroutine.	rate_limit http middleware cleanup gc goroutine infra pendiente-usar		RateLimiter_go_infra		false	error_go_core	time	name desc rl puntero al RateLimiter cuyas entries se purgaran name desc maxAge edad maxima sin actividad antes de purgar una entry (ej: 10*time.Minute) name desc interval frecuencia del barrido de purga (ej: 5*time.Minute). 0 usa default 1 minuto	funcion stop sin argumentos que detiene la goroutine de cleanup. Idempotente — llamarla varias veces es seguro	true	purga entries con lastSeen mas antiguo que maxAge no purga entries recientes stop detiene la goroutine sin panic stop es idempotente	functions/infra/rate_limiter_cleanup_test.go	functions/infra/rate_limiter_cleanup.go

Ejemplo

rl := RateLimiterNew(10, 20)
stop := RateLimiterCleanup(rl, 10*time.Minute, 5*time.Minute)
defer stop()

// Servir requests... el GC limpia entries inactivas en background.

Notas

Funcion impura — arranca una goroutine, depende de tiempo wall-clock. La goroutine se cierra al invocar la funcion retornada (cierra un channel interno). Sin invocar stop la goroutine vive hasta que el proceso termina (leak). Valores <= 0 para interval o maxAge se sustituyen por defaults seguros (1 min / 10 min). El barrido toma el mutex del limiter — un interval muy corto puede causar contencion en limiters con muchas keys.