---
name: crud_list_handler
kind: function
lang: go
domain: infra
version: "1.0.0"
purity: impure
signature: "func CRUDListHandler(res CRUDResource, db *sql.DB) http.HandlerFunc"
description: "Genera un handler HTTP GET que lista registros de la tabla del recurso con paginacion, orden y filtros desde los query params. Responde con un CRUDListResult JSON. Valida sort_by y filter_* contra la definicion del recurso para evitar SQL injection."
tags: [crud, list, handler, http, sqlite, pagination, infra]
uses_functions: [http_json_response_go_infra, http_error_response_go_infra]
uses_types: [CRUDResource_go_infra, CRUDListParams_go_infra, CRUDListResult_go_infra, HTTPError_go_infra]
returns: []
returns_optional: false
error_type: "error_go_core"
imports: [database/sql, fmt, net/http, strconv, strings]
params:
  - name: res
    desc: "definicion del recurso (tabla, campos, soft_delete)"
  - name: db
    desc: "conexion *sql.DB a SQLite con la tabla ya creada"
output: "http.HandlerFunc que lista registros segun query params"
tested: true
tests: ["devuelve lista vacia si no hay registros", "pagina resultados con page y per_page", "filtra por campo con filter_<field>", "ordena con sort_by y sort_dir", "ignora soft-deleted si soft_delete"]
test_file_path: "functions/infra/crud_test.go"
file_path: "functions/infra/crud_list_handler.go"
---

## Ejemplo

```go
handler := CRUDListHandler(res, db)
mux.Handle("GET /api/projects", handler)
// curl "localhost:8080/api/projects?page=1&per_page=10&sort_by=name&sort_dir=asc&filter_status=active"
```

## Notas

Impura — hace SELECT y COUNT contra SQLite. Los query params soportados son: page (default 1), per_page (default 20, max 100), sort_by (default "created_at"), sort_dir ("asc"|"desc", default "desc") y filter_<campo> con igualdad exacta. Los nombres de campo en sort_by y filter_* se validan contra la definicion del recurso — cualquier valor no reconocido se ignora (defensa contra SQLi). Si el recurso es SoftDelete, se anade WHERE deleted_at IS NULL automaticamente.
