Files
doormile_backend/utils/pagination_test.go
Suriya 2c26cbe4ba fix: panic recovery, rate limiting, transaction error handling, pagination
Hardening pass over the API surface. No route's auth requirements change.

Resilience:
- Add recover middleware. There was none, so an unhandled panic in any
  handler propagated out of the process instead of becoming a 500.
- Add a centralized ErrorHandler so errors and recovered panics return the
  same {success,message} envelope as the utils helpers, not Fiber's default
  plain-text body. 5xx responses are logged with method and path.

Rate limiting:
- Global 300/min per IP as an abuse backstop, exempting health/readiness
  probes and websocket upgrades.
- 10/min shared across every credential endpoint (customer/miler/admin/hub
  login, verify-pin, reset-pin, email OTP). PINs are 4 digits, so the whole
  keyspace was previously walkable in seconds. One shared limiter instance
  means rotating between endpoints doesn't reset the budget.
- Add TRUSTED_PROXIES config. Limits key on c.IP(), which behind a TLS
  terminator is the proxy, collapsing every client into one bucket. When set,
  X-Forwarded-For is honoured only from those proxies so the header can't be
  spoofed to dodge the limit. Logs a warning when unset.

Transactions:
- Check the error on all 51 previously-unchecked tx.Save/Create/Delete/
  Model(...).Update/Commit calls across 6 controllers. A failed write inside
  a transaction was silently ignored and the request still reported success;
  an unchecked Commit could fail with the caller told everything worked.
  Each site now rolls back and returns a specific message.

Pagination:
- Add utils.ParsePage/Paginated, reusing the pageno/pagesize convention
  GetAdminBookings already established. Default 500, hard cap 1000.
- Apply to the previously unbounded consignments, tripsheets, exceptions,
  app-users and clients endpoints. Defaults are high so existing consoles
  that don't paginate keep working; the cap only stops a growing table from
  being loaded wholesale. total is now a real COUNT, not len(data).
- GetClients also loaded the entire auth table to join in memory; it now
  fetches only the current page's rows.

Tests (first in the repo):
- Extract the hyperlocal pincode rule out of BookingPickupComplete into
  isHyperlocal so it is testable, covering the short/empty pincode fallback.
- Cover calculateVolumetricWeight and the ParsePage clamping rules.

Repo hygiene:
- Tag scratch/*.go with //go:build ignore. Each declared its own main(), so
  `go build ./...` failed on redeclaration; it now passes repo-wide.
- Untrack scratch/node_modules (216 files) and ignore node_modules, test
  artifacts, and the `doormile` binary `go build .` emits.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-27 12:13:39 +05:30

114 lines
2.9 KiB
Go

package utils
import (
"net/http/httptest"
"testing"
"github.com/gofiber/fiber/v2"
)
// pageFor spins a request through a throwaway Fiber app so ParsePage sees a
// real *fiber.Ctx rather than a hand-built stub.
func pageFor(t *testing.T, query string) Page {
t.Helper()
var got Page
app := fiber.New()
app.Get("/", func(c *fiber.Ctx) error {
got = ParsePage(c)
return nil
})
resp, err := app.Test(httptest.NewRequest("GET", "/?"+query, nil))
if err != nil {
t.Fatalf("test request failed: %v", err)
}
_ = resp.Body.Close()
return got
}
func TestParsePageDefaults(t *testing.T) {
p := pageFor(t, "")
if p.No != 1 {
t.Errorf("No = %d, want 1", p.No)
}
if p.Size != DefaultPageSize {
t.Errorf("Size = %d, want %d", p.Size, DefaultPageSize)
}
if p.Offset != 0 {
t.Errorf("Offset = %d, want 0", p.Offset)
}
}
func TestParsePageClamping(t *testing.T) {
cases := []struct {
name string
query string
wantNo int
wantSize int
wantOffset int
}{
{
name: "explicit page and size", query: "pageno=3&pagesize=20",
wantNo: 3, wantSize: 20, wantOffset: 40,
},
{
// A client must not be able to opt back into an unbounded scan.
name: "oversized pagesize is capped", query: "pagesize=999999",
wantNo: 1, wantSize: MaxPageSize, wantOffset: 0,
},
{
name: "zero page falls back to first", query: "pageno=0",
wantNo: 1, wantSize: DefaultPageSize, wantOffset: 0,
},
{
name: "negative page falls back to first", query: "pageno=-5",
wantNo: 1, wantSize: DefaultPageSize, wantOffset: 0,
},
{
name: "zero pagesize falls back to default", query: "pagesize=0",
wantNo: 1, wantSize: DefaultPageSize, wantOffset: 0,
},
{
name: "negative pagesize falls back to default", query: "pagesize=-10",
wantNo: 1, wantSize: DefaultPageSize, wantOffset: 0,
},
{
// Garbage must degrade to defaults, not fail the request.
name: "non-numeric values fall back to defaults", query: "pageno=abc&pagesize=xyz",
wantNo: 1, wantSize: DefaultPageSize, wantOffset: 0,
},
{
name: "offset is derived from page and size", query: "pageno=5&pagesize=100",
wantNo: 5, wantSize: 100, wantOffset: 400,
},
}
for _, tc := range cases {
t.Run(tc.name, func(t *testing.T) {
p := pageFor(t, tc.query)
if p.No != tc.wantNo {
t.Errorf("No = %d, want %d", p.No, tc.wantNo)
}
if p.Size != tc.wantSize {
t.Errorf("Size = %d, want %d", p.Size, tc.wantSize)
}
if p.Offset != tc.wantOffset {
t.Errorf("Offset = %d, want %d", p.Offset, tc.wantOffset)
}
})
}
}
func TestParsePageNeverExceedsMax(t *testing.T) {
// Guards the invariant the cap exists for, independent of the table above.
for _, q := range []string{"pagesize=1001", "pagesize=5000", "pagesize=2147483647"} {
if p := pageFor(t, q); p.Size > MaxPageSize {
t.Errorf("%s produced Size = %d, which exceeds MaxPageSize %d", q, p.Size, MaxPageSize)
}
}
}