supabase / supabase-swift / 33489224556

88%

push

github

feat(postgrest): add count and head to the typed surface (#1305)

Add `count(_:)` on the typed query — a HEAD request that returns the
matching row total without transferring rows — and an `execute(count:)`
overload on both the typed query and the typed mutation, for the page
and the total in one round trip.

Two departures from the issue as written:

`executeWithResponse()` is not needed. Typed `execute()` already returns
`PostgrestResponse<Output>`; spec §4.8 was written against an
`execute() -> [Todo]` shape the typed surface never adopted. The only
missing piece was asking for the count, so that is a `count:` overload
rather than a second execute method.

SDK-1638 is not a blocker. The count preference is applied at send time
by `PostgrestRequestBuilder.execute(options:)`, after `returning()` has
written `Prefer`, and `HTTPFields.appendOrUpdate` replaces only the
component sharing a `key=` prefix. So `return=representation` and
`count=exact` already compose.

Count applies to mutations via `execute(count:)` only — a terminal
`count()` there would read like a read while performing the write. The
HEAD-only form stays query-side, since HEAD-ing a mutation is
meaningless.

Both are overloads, not defaulted parameters, so no existing symbol
changes and the API stability check stays green.

18 of 18 new or added lines in 2 files covered. (100.0%)

9597 of 10966 relevant lines covered (87.52%)

178.8 hits per line