---
name: job_queue_create
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func JobQueueCreate(db *sql.DB, tableName string) (*JobQueue, error)"
description: "Crea (o verifica) la tabla de jobs con indices en SQLite, activa WAL mode, y retorna un *JobQueue listo para usar. tableName puede ser cualquier identificador SQLite valido (default: 'jobs')."
tags: [job, queue, sqlite, async, background, infra, create, schema]
uses_functions: []
uses_types: [job_queue_go_infra]
returns: [job_queue_go_infra]
returns_optional: false
error_type: "error_go_core"
imports: [database/sql, fmt]
params:
  - name: db
    desc: "conexion SQLite abierta (puede ser :memory: o file-based)"
  - name: tableName
    desc: "nombre de la tabla de jobs; si esta vacio se usa 'jobs'"
output: "puntero a JobQueue con DB y TableName configurados, listo para enqueue/dequeue"
tested: true
tests:
  - "test_queue_create"
  - "test_queue_create_default_table_name"
  - "test_queue_create_nil_db"
test_file_path: "functions/infra/job_queue_test.go"
file_path: "functions/infra/job_queue_create.go"
---

## Ejemplo

```go
db, _ := sql.Open("sqlite3", "jobs.db?_journal_mode=WAL")
q, err := JobQueueCreate(db, "jobs")
if err != nil {
    log.Fatal(err)
}
// q esta listo para JobEnqueue, JobDequeue, etc.
```

## Notas

Activa WAL mode en la DB. Usa `CREATE TABLE IF NOT EXISTS` y `CREATE INDEX IF NOT EXISTS` — es seguro llamarlo multiples veces. Indices creados: `idx_{table}_dequeue` (filtrado partial por status='pending'), `idx_{table}_status`, `idx_{table}_type`.
