feat: add GET /v1/receipts listing endpoint with offset/limit pagination

Author: YASSERRMD

internal/api/ingest.go

@@ -7,6 +7,7 @@ import (
 	"errors"
 	"log"
 	"net/http"
+	"strconv"
 	"time"
 
 	"github.com/google/uuid"
@@ -97,6 +98,47 @@ func (s *Server) handleIngestBatch(w http.ResponseWriter, r *http.Request) {
 	writeJSON(w, http.StatusCreated, map[string]any{"count": len(receipts), "receipts": receipts})
 }
 
+// ListReceiptsResponse is returned by GET /v1/receipts.
+type ListReceiptsResponse struct {
+	Receipts []vur.Receipt `json:"receipts"`
+	Offset   int           `json:"offset"`
+	Limit    int           `json:"limit"`
+	Count    int           `json:"count"`
+}
+
+func (s *Server) handleListReceipts(w http.ResponseWriter, r *http.Request) {
+	const defaultLimit = 50
+	const maxLimit = 500
+
+	offset, _ := strconv.Atoi(r.URL.Query().Get("offset"))
+	limit, _ := strconv.Atoi(r.URL.Query().Get("limit"))
+	if limit <= 0 {
+		limit = defaultLimit
+	}
+	if limit > maxLimit {
+		limit = maxLimit
+	}
+	if offset < 0 {
+		offset = 0
+	}
+
+	stored, err := s.store.ListReceipts(offset, limit)
+	if err != nil {
+		writeError(w, http.StatusInternalServerError, "list receipts: "+err.Error())
+		return
+	}
+	receipts := make([]vur.Receipt, len(stored))
+	for i, sr := range stored {
+		receipts[i] = sr.Receipt
+	}
+	writeJSON(w, http.StatusOK, ListReceiptsResponse{
+		Receipts: receipts,
+		Offset:   offset,
+		Limit:    limit,
+		Count:    len(receipts),
+	})
+}
+
 func (s *Server) handleGetReceipt(w http.ResponseWriter, r *http.Request) {
 	id := r.PathValue("id")
 	sr, err := s.store.GetReceiptByID(id)

internal/api/server.go

@@ -114,6 +114,7 @@ func (s *Server) Routes() *http.ServeMux {
 	// Receipt routes
 	mux.HandleFunc("POST /v1/receipts", s.handleIngest)
 	mux.HandleFunc("POST /v1/receipts/batch", s.handleIngestBatch)
+	mux.HandleFunc("GET /v1/receipts", s.handleListReceipts)
 	mux.HandleFunc("GET /v1/receipts/{id}", s.handleGetReceipt)
 	mux.HandleFunc("GET /v1/receipts/{id}/proof", s.handleInclusionProof)
 	mux.HandleFunc("GET /v1/receipts/{id}/attestation", s.handleAttestation)