fn_registry/functions/infra/job_worker.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
job_worker	function	go	infra	1.0.0	impure	func JobWorker(ctx context.Context, q *JobQueue, handler JobHandler, opts ...WorkerOption) error	Ejecuta un poll loop bloqueante que desencola y procesa jobs hasta que el context sea cancelado. El handler determina complete vs fail. Opciones: WithPollInterval (default 1s), WithJobTypes.	job queue worker goroutine poll async background infra concurrency	job_dequeue_go_infra job_complete_go_infra job_fail_go_infra	job_queue_go_infra job_go_infra		false	error_go_core	context fmt time	name desc ctx context que al cancelarse detiene el worker limpiamente (graceful shutdown) name desc q cola de jobs creada con JobQueueCreate name desc handler funcion que procesa un job; retorno nil = completado, error = fallo name desc opts opciones: WithPollInterval(d), WithJobTypes(types...)	ctx.Err() cuando el context se cancela, o error de configuracion	true	worker_graceful_shutdown worker_processes_jobs	functions/infra/job_queue_test.go	functions/infra/job_worker.go

Ejemplo

ctx, cancel := context.WithCancel(context.Background())
defer cancel()

go JobWorker(ctx, q, func(job Job) error {
    fmt.Println("processing", job.ID, job.Type)
    return nil // complete
}, WithPollInterval(500*time.Millisecond), WithJobTypes("send_email"))

Notas

Funcion bloqueante — ejecutar en una goroutine. Retorna ctx.Err() cuando el context se cancela (graceful shutdown). Los errores transitorios de dequeue (DB) generan un sleep y retry. El handler tiene la responsabilidad completa del procesamiento; JobWorker se encarga de complete/fail.