supabase / supabase-flutter / 29030706929

87%

push

github

refactor: extract shared code into supabase_common package (#1573)

## What

Introduces a new published `supabase_common` package and moves the
**non-breaking** shared/duplicated code from #1572 into it.

**Stacked:** `main` ← #1569 (drop rxdart) ← #1571 (drop retry, in-house
helper) ← **this PR**.

> [!NOTE]
> Review/merge in stack order. Retarget this PR's base as each parent
merges (→ `refactor/inline-retry`, then `refactor/supabase-drop-rxdart`,
then `main`).

## Moved into `supabase_common`

| Item | Was |
|------|-----|
| `ToSnakeCase` enum extension | duplicated (byte-for-byte) in `gotrue`
+ `storage_client` |
| Platform detection (`platform_io`/`platform_stub`) | duplicated in
`supabase` + `supabase_flutter` (kept the extra
`isRunningInFlutterTest`) |
| `buildClientInfoHeader` (`X-Client-Info`) | built in all 7 client
packages (simple + platform-aware forms) |
| `isSuccessStatusCode` (2xx) | inlined/duplicated in `gotrue`,
`storage_client`, `postgrest`, `functions_client` |
| `FetchOptions` | duplicated internally in `gotrue` + `storage_client`
|
| `Base64Url` / PKCE / uuid helpers | `gotrue`-only; also fixes an
intra-`gotrue` duplication in `jwt.dart` |
| `ReplaySubject` | unifies gotrue's `_ReplaySubject` and supabase's
`_BehaviorSubject` |
| `retry` / `RetryOptions` helper | the in-house copy #1571 added to
`gotrue` + `storage_client` (identical); `@internal` dropped since it is
now used across packages |

## Not included

- **Tier 3** (shared exception base, HTTP fetch wrappers, `RetryTimer`)
— breaking, tracked under v3 (#1278).

## Notes

- `supabase_common` is an internal, published package (client packages
cannot depend on an unpublished local package). Its README flags it as
internal with breaking changes expected.
- Registered in the workspace, `test.yml` (`DART_PACKAGES` + Coveralls
carryforward), and `release-pana.yml`.
- No public API changes: every moved symbol was either internal or
re-exported so consumers importing from the cl... (continued)

109 of 117 new or added lines in 21 files covered. (93.16%)

4551 of 5259 relevant lines covered (86.54%)

3.97 hits per line