Files
fn_registry/functions/infra/crud_list_handler.md
T
egutierrez 28599436e5 feat(crud): handlers HTTP y registro de rutas para recursos CRUD
Anade los 5 handlers CRUD genericos (list, get, create, update, delete) a
partir de un CRUDResource y *sql.DB, la factory crud_generate_handlers que
compone los 5 en un mapa, y crud_register_routes que registra todas las
rutas REST en un http.ServeMux con la sintaxis METHOD /path de Go 1.22+.

Caracteristicas:
- List con paginacion (page, per_page), orden (sort_by, sort_dir) y
  filtros exactos (filter_<campo>), validando nombres de columna contra
  la definicion del recurso para evitar SQL injection.
- Create valida required y validaciones (min/max, min_length/max_length,
  pattern, enum) antes de insertar; mapea UNIQUE violations a 409.
- Update hace partial update — solo los campos presentes en el JSON.
- Delete hace hard delete o soft delete segun CRUDResource.SoftDelete.
- UUIDs generados via github.com/google/uuid; timestamps en RFC3339Nano UTC.

Los handlers usan las funciones HTTP del registry (http_json_response,
http_error_response, http_parse_body) y se pueden componer con el mux
via http_router.
2026-04-18 17:15:33 +02:00

2.0 KiB

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
crud_list_handler function go infra 1.0.0 impure func CRUDListHandler(res CRUDResource, db *sql.DB) http.HandlerFunc 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.
crud
list
handler
http
sqlite
pagination
infra
http_json_response_go_infra
http_error_response_go_infra
CRUDResource_go_infra
CRUDListParams_go_infra
CRUDListResult_go_infra
HTTPError_go_infra
false error_go_core
database/sql
fmt
net/http
strconv
strings
name desc
res definicion del recurso (tabla, campos, soft_delete)
name desc
db conexion *sql.DB a SQLite con la tabla ya creada
http.HandlerFunc que lista registros segun query params true
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
functions/infra/crud_test.go functions/infra/crud_list_handler.go

Ejemplo

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_ 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.