27945378487
85%

Ran 22 Jun 2026 10:13AM UTC

Jobs 8

Files 78

Run time 1min

Badge

Embed ▾

Committed 22 Jun 2026 10:11AM UTC coverage: 85.201%. Remained the same

Build # 27945378487

Build Type

push

github

Committed by

web-flow

Commit Message

docs(gotrue): clarify Session.expiresAt is in seconds (#1447)

## Description

Clarifies the doc comment for `Session.expiresAt` to state that the
value is a Unix timestamp in **seconds**, and shows the correct
conversion to `DateTime`.

## Context

While investigating #1202 ("Session expiresAt always corrupted after hot
restart"), I verified the reported symptom is **not a library bug**:

- `Session.expiresAt` is derived from the access token's JWT `exp` claim
(unix seconds), not from the persisted `expires_at` JSON value.
`Session.fromJson` doesn't even read `expires_at`, so
persistence/deserialization cannot corrupt it.
- Every internal consumer (`isExpired`, the auto-refresh tick,
`supabase_client.dart`) correctly multiplies by 1000.
- The reporter's logged `1970-...` date decodes to a millisecond value
that is exactly a valid 2026 **seconds** timestamp, i.e. their own code
passed `expires_at` (seconds) into `DateTime.fromMillisecondsSinceEpoch`
without `* 1000`.

The real underlying problem is an ergonomics footgun: the previous doc
comment didn't state the unit. This PR fixes that.

No behavior change; existing `session_test.dart` tests pass.

Refs #1202

Coverage Stats

4082 of 4791 relevant lines covered (85.2%)

3.49 hits per line

Jobs

ID	Job ID	Ran	Files	Coverage
6	supabase - 27945378487.6	22 Jun 2026 10:13AM UTC	15	82.3	GitHub Action Run
7	gotrue - 27945378487.7	22 Jun 2026 10:15AM UTC	26	83.53	GitHub Action Run
8	supabase_flutter - 27945378487.8	22 Jun 2026 10:14AM UTC	9	77.08	GitHub Action Run
7	yet_another_json_isolate - 27913856643.7	21 Jun 2026 06:42PM UTC	1	79.03	GitHub Action Run
4	realtime_client - 27916391162.4	21 Jun 2026 08:26PM UTC	11	88.15	GitHub Action Run
2	functions_client - 27916391162.2	21 Jun 2026 08:24PM UTC	2	97.14	GitHub Action Run
7	postgrest - 27916391162.7	21 Jun 2026 08:26PM UTC	9	83.81	GitHub Action Run
8	storage_client - 27916391162.8	21 Jun 2026 08:25PM UTC	5	93.01	GitHub Action Run

supabase / supabase-flutter / 27945378487
85%

README BADGES
x

Markdown

Textile

RDoc

HTML

Rst

Jobs

Source Files on build 27945378487

supabase / supabase-flutter / 27945378487 85%

README BADGES x

Markdown

Textile

RDoc

HTML

Rst

Jobs

Source Files on build 27945378487

supabase / supabase-flutter / 27945378487
85%

README BADGES
x