fn_registry/functions/infra/job_dequeue.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_dequeue	function	go	infra	1.0.0	impure	func JobDequeue(q *JobQueue, jobTypes []string) (*Job, error)	Extrae atomicamente el siguiente job disponible usando SELECT+UPDATE en una transaccion exclusiva. Retorna nil, nil si la cola esta vacia o no hay jobs que cumplan el filtro. jobTypes limita los tipos dequeued; slice vacio significa todos.	job queue dequeue atomic transaction sqlite async background infra		job_queue_go_infra job_go_infra job_status_go_infra	job_go_infra	true	error_go_core	database/sql errors fmt strings time	name desc q cola de jobs creada con JobQueueCreate name desc jobTypes lista de tipos a desencolar; slice vacio o nil = todos los tipos	puntero a Job con status=running, o nil si la cola esta vacia	true	enqueue_dequeue_atomicidad dequeue_empty_queue_returns_nil dequeue_priority_order dequeue_jobtype_filter dequeue_scheduled_in_future_waits	functions/infra/job_queue_test.go	functions/infra/job_dequeue.go

Ejemplo

// Desencolar cualquier tipo
job, err := JobDequeue(q, nil)
if job == nil {
    // cola vacia
}

// Filtrar por tipo
job, err = JobDequeue(q, []string{"send_email", "send_sms"})

Notas

Usa db.Begin() + tx.Rollback() (deferred) + tx.Commit(). El SELECT filtra por status='pending' AND scheduled_at <= now y ordena por priority DESC, scheduled_at ASC. El UPDATE atomico cambia el status a 'running' y setea started_at. Safe para multiples workers concurrentes — SQLite serializa la transaccion.