postgrest

Pre-release versioning run for the v3 train. Every published SDK package
lands on 3.0.0-dev.1 so the whole set can go to pub.dev as a coherent
prerelease.

Versions

supabase_auth, supabase_functions, supabase_realtime and
supabase_storage already carried 3.0.0-dev.1 in their pubspec, but
that number was hand-set during the package renames and never published,
so no matching changelog section existed. This run generates it and
leaves the version where it is.

iceberg

iceberg stays on 0.1.0. It has never been published, so its
accumulated changes are folded into the existing ## 0.1.0 changelog
section instead of opening a new one. supabase_storage keeps its
iceberg: 0.1.0 constraint.

Not versioned

• yet_another_json_isolate stays on 2.1.1
• supabase_testing stays on 0.1.0
• supabase_lints and supabase_typegen stay on 0.1.1, they version on
  their own tooling track

Their pubspec versions and changelogs are untouched, as are the
constraints pointing at them (yet_another_json_isolate: 2.1.1,
supabase_lints: ^0.1.1).

What changed

• Package pubspec.yaml versions plus the intra-workspace dependency
  constraints between them
• lib/src/version.dart for postgrest, supabase and
  supabase_flutter, regenerated by the update-version melos hook
• Per-package CHANGELOG.md and the workspace CHANGELOG.md
• supabase_flutter: ^3.0.0-dev.1 and supabase: ^3.0.0-dev.1 in the
  example apps

How it was generated

melos version with an explicit --manual-version entry for every
package that had versionable commits, so nothing was auto-bumped by
conventional-commit inference. Packages held back from the release were
passed their current version to stop melos auto-versioning them, and the
resulting no-op changelog sections were dropped again.

Verification

• flutter pub get resolves the workspace, pubspec.lock needs no
  change
• dart analyze --fatal-infos reports no issues

Tagging and publishing are left to release-tag.yml and
release-publish.yml once this merges.

Summary by CodeRabbit

• New Features

• Introduced the Supabase Flutter v3.0.0-dev.1 release, including
  improved realtime streams, asynchronous codecs, per-flow PKCE storage,
  unified retry configuration, and enhanced JSON performance.

• Added shared testing utilities and the new supabase_testing package.

  • Added Iceberg package v0.1.0.

• Bug Fixes

• Improved authentication redirect and session parsing, access-token
  handling, storage behavior, and resource disposal.

• Documentation

• Added comprehensive changelogs, breaking-change notes, and a v2-to-v3
  migration guide.

• REFACTOR: share the test helpers through supabase_common (#1745). (bcb41fa4)
• REFACTOR: share the auth callback parameters and secure random helpers (#1744). (66ac4901)
• REFACTOR: share the HTTP request pieces between the fetch layers (#1647). (a2a9eeaa)
• FIX(supabase_lints): enable lines_longer_than_80_chars and fix all violations (#1655). (a08b6577)
• FIX(supabase_common): accept uppercase and mixed-case UUIDs in validation (#1656). (691690cf)
• FEAT: introduce the supabase_testing package (#1747). (5a3aa9b4)
• FEAT: resolve an access token per request on the standalone clients (#1742). (dd61782a)
• FEAT(storage): expose the service error code on StorageException (#1657). (4f9cabfe)
• DOCS: fix inaccurate dartdoc comments across all packages (#1659). (090ee978)
• BREAKING REFACTOR(storage): share one SortDirection enum across the packages (#1752). (38396ed5)
• BREAKING REFACTOR: rework logging to emit only through the supabase logger hierarchy (#1741). (d1642c80)
• BREAKING REFACTOR: share one retry configuration across the clients (#1738). (3b2a4855)
• BREAKING REFACTOR: spell out abbreviations in the public API (#1712). (29286f43)
• BREAKING REFACTOR: share one exponential backoff calculation (#1646). (8bc93f5d)
• BREAKING REFACTOR: split every service exception into a client and an api base (#1644). (0202c332)
• BREAKING REFACTOR: share a single HttpMethod enum across the packages (#1678). (23d55c37)
• BREAKING FIX(supabase_flutter): persist the session with SharedPreferencesAsync (#1680). (41500b73)
• BREAKING FEAT: rename the storage_client package to supabase_storage (#1715). (6b0388f2)
• BREAKING FEAT: rename the realtime_client package to supabase_realtime (#1714). (d37bed56)
• BREAKING FEAT: rename the functions_client package to supabase_functions (#1713). (eb4f3773)
• BREAKING FEAT: rename the gotrue package to supabase_auth (#1697). (563b502e)
• BREAKING FEAT: use DateTime for all timestamp fields (#1663). (bad3af8f)

Note: This release has breaking changes.

• REFACTOR: share the test helpers through supabase_common (#1745). (bcb41fa4)
• REFACTOR: share the auth callback parameters and secure random helpers (#1744). (66ac4901)
• REFACTOR: share the HTTP request pieces between the fetch layers (#1647). (a2a9eeaa)
• PERF(yet_another_json_isolate): process small payloads inline and large ones on short-lived isolates (#1746). (7942c377)
• FIX(supabase_lints): enable lines_longer_than_80_chars and fix all violations (#1655). (a08b6577)
• FEAT: introduce the supabase_testing package (#1747). (5a3aa9b4)
• FEAT: resolve an access token per request on the standalone clients (#1742). (dd61782a)
• DOCS: fix inaccurate dartdoc comments across all packages (#1659). (090ee978)
• BREAKING REFACTOR: process JSON through the AsyncJsonCodec interface (#1751). (6969eb38)
• BREAKING REFACTOR(postgrest): make the rest client and builders stateless (#1748). (4efb8ce4)
• BREAKING REFACTOR: rework logging to emit only through the supabase logger hierarchy (#1741). (d1642c80)
• BREAKING REFACTOR: remove the dead setAccessToken mutators (#1739). (ced47232)
• BREAKING REFACTOR: share one retry configuration across the clients (#1738). (3b2a4855)
• BREAKING REFACTOR(postgrest): fix the retried status codes to 503 and 520 (#1737). (17487ff5)
• BREAKING REFACTOR(postgrest): expose retry configuration as PostgrestRetryOptions (#1731). (7c0cfe53)
• BREAKING REFACTOR: spell out abbreviations in the public API (#1712). (29286f43)
• BREAKING REFACTOR: share one exponential backoff calculation (#1646). (8bc93f5d)
• BREAKING REFACTOR: split every service exception into a client and an api base (#1644). (0202c332)
• BREAKING REFACTOR: share a single HttpMethod enum across the packages (#1678). (23d55c37)
• BREAKING REFACTOR: remove analyzer ignores by fixing the underlying code (#1675). (9f367d77)
• BREAKING REFACTOR: remove all deprecated APIs and dead public surface for v3 (#1661). (1ffa0deb)
• BREAKING FIX: make order() default to ascending (#1658). (e06f2302)

• REFACTOR(supabase_common): share the local stack test configuration (#1640). (a08f06d3)
• DOCS(postgrest): document that order() defaults to descending (#1637). (dc93d761)

• REFACTOR(supabase_common): share the local stack test configuration (#1640). (a08f06d3)
• FEAT(storage): add purgeCache to invalidate CDN cache for a single object (#1607). (4acd0a01)

• FIX(postgrest): override limit and offset instead of appending duplicates (#1512). (f1c80d60)
• FEAT(postgrest): add format option to explain() (#1516). (e549d390)

• FIX(postgrest): stop seeding Prefer header with an empty string (#1505). (0a37f0d7)

• FIX(postgrest): escape quotes and backslashes in list filter values (#1481). (66e4d139)
• FIX(postgrest): return structured error for non-JSON body on 2xx responses (#1474). (2d7c9cf5)
• FIX: correctness fixes across gotrue, postgrest, storage, supabase and supabase_flutter (#1445). (bf31389d)
• FIX(postgrest): build a valid Prefer header in select() when none is set (#1433). (871d39d5)

• FIX: raise min Dart SDK to 3.4.0 across all packages (#1409). (311f883f)

• FIX(postgrest): include caller frames in PostgrestException stack traces (#1387). (716121a5)

• REFACTOR: extract shared code into supabase_common package (#1573). (46601bbb)
• FEAT(functions): add request cancellation to invoke via abortSignal (#1593). (b994dabd)
• FEAT(functions): expose FunctionsFetchException/FunctionsRelayException/FunctionsHttpException subtypes (#1545). (2d3a7202)

• FIX(types): improve JSON decoding resilience (#1301). (1523f5d6)
• FIX(postgrest): replace SCREAMING_SNAKE_CASE HTTP method constants with enum (#1347). (13e8b39e)
• FEAT(postgrest): add automatic retry for transient failures (#1338). (fb1da8b2)

• FEAT(storage): add download option to signed and public URLs (#1514). (2c0370c1)
• FEAT(storage): add upsert option to createSignedUploadUrl (#1515). (6f6ea5cd)

• FEAT(postgrest): add missing PostgREST v12 operators (#1273). (f6270260)

• FEAT(storage): add setHeader method for custom HTTP headers (#1313). (99231538)
• FEAT(storage): add queryParams support to download method (#1291). (6f56c193)
• FEAT(storage_client): use dedicated storage host for storage lib (allows >50GB uploads) (#1285). (8e0993c6)

2025-12-10

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• gotrue - v2.18.0
• postgrest - v2.6.0
• realtime_client - v2.7.0
• supabase_flutter - v2.12.0
• supabase - v2.10.2

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase - v2.10.2

• FIX(postgrest): URL replacement logic in query builder (#1228). (908976c5)
• FEAT(postgrest): Implement maxAffected method (#1226). (ae2d12d9)

• FIX: FunctionException implements Exception (#1134). (79edb81c)

• Update a dependency to the latest release.

• REFACTOR: Remove unnecessary parentheses in Bucket.fromJson (#1201). (d729fa46)
• FIX(storage): Resolve MultipartRequest finalization error in retry mechanism (#1208). (2b818e08)

• DOCS: Fix typo for RPC docs (#1105). (7c8c8630)

• FEAT(storage_client): Custom-metadata, exists, info methods (#1023). (4d3f4bf5)

• FEAT: Read-only access mode rpc (#1081). (d0a04154)

• FEAT: Support mime 2.0.0 (#1079).

• FEAT: Add logging (#1042). (d1ecabd7)

• FEAT: Add logging (#1042). (d1ecabd7)

• FEAT: Add setHeader method on postgrest builder (#1003). (efe8e5df)

• FIX: Upgrade web_socket_channel for supporting web: ^1.0.0 and therefore WASM compilation on web (#992). (7da68565)

• Update a dependency to the latest release.

• FIX(postgrest): Update parameter type of isFilter() to only allow boolean or null (#920). (0a3b73e0)
• FIX(postgrest): Update parameter type of match() filter so that null values cannot be passed. (#919). (0902124f)

• FIX: raise min Dart SDK to 3.4.0 across all packages (#1409). (311f883f)

2026-06-09

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• postgrest - v2.7.1
• realtime_client - v2.7.4
• storage_client - v2.5.6
• supabase_flutter - v2.14.2
• supabase - v2.12.2

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase - v2.12.2

• DOCS(postgrest): Expand documentation for contains and containedBy methods (#824). (e241e766)

• FEAT: Add debugName parameter to YAJsonIsolate. (#1118). (23ffc0e9)

2025-02-24

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• functions_client - v2.4.1
• realtime_client - v2.4.2
• storage_client - v2.3.1
• supabase - v2.6.3
• supabase_flutter - v2.8.4

• FIX: Passing null to not() filter is now allowed (#775). (13f02286)
• FEAT(postgrest): Add toJson() method to PostgrestException to allow serialization (#783). (28c9819a)

• FIX: Make sure the package can be built on Flutter web (#990). (742b761c)

2024-07-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• functions_client - v2.3.0
• supabase - v2.2.6
• supabase_flutter - v2.5.10

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase - v2.2.6
• supabase_flutter - v2.5.10

• FIX: enable filtering and tranformation on count with head (#768). (d66aaab6)

2023-12-05

Changes

Packages with breaking changes:

• realtime_client - v2.0.0-dev.3
• postgrest - v2.0.0-dev.2
• supabase - v2.0.0-dev.4

Packages with other changes:

• gotrue - v2.0.0-dev.2
• supabase_flutter - v2.0.0-dev.4

• Graduate package to a stable release. See pre-releases prior to this version for changelog entries.

• FIX: PKCE flow not emitting password recovery event (#744). (65859bd2)
• FIX: sign out on already used refresh token (#740). (72ffb9ee)
• FIX(gotrue): signing in with pkce flow fires two signedIn auth event (#734). (6dee1660)
• FEAT(gotrue): add Figma to OAuth provider. (#743). (f5b72d47)

• REFACTOR: make schema variable private and rename useSchema() to schema() (#737).

• FIX: issue where .range() not respecting the offset given. (#722). (e3541a46)
• FEAT: adds geojson support for working with the PostGIS extension (#721). (60a25153)
• FEAT: adds .explain() for debugging performance issues on Supabase client generated queries. (#719). (f6e41578)

Note: This release has breaking changes.

• FIX: issue where .range() not respecting the offset given. (#722). (e3541a46)
• FEAT: adds geojson support for working with the PostGIS extension (#721). (60a25153)
• FEAT: adds .explain() for debugging performance issues on Supabase client generated queries. (#719). (f6e41578)

• FIX(functions_client): use header for response parsing (#616). (e413acbb)
• BREAKING REFACTOR: use Dart 3 (#598). (02c4071a)
• BREAKING FIX: throw exception on non 2xx status (#629). (db5ec824)
• BREAKING FEAT: use Object? instead of dynamic (#606). (0c6caa00)

Note: This release has breaking changes.

• FIX: don't try to decode an empty body (#631). (ec13c88f)
• FEAT(postgrest): immutability (#600). (95256697)
• DOCS: update readme to v2 (#647). (514cefb4)
• BREAKING REFACTOR: rename is_ and in_ to isFilter and inFilter (#646). (1227394e)
• BREAKING REFACTOR: many auth breaking changes (#636). (7782a587)
• BREAKING REFACTOR: use Dart 3 (#598). (02c4071a)
• BREAKING FEAT(postgrest): stronger type system for query building (#624). (951ce89e)
• BREAKING FEAT: use Object? instead of dynamic (#606). (0c6caa00)

• FIX: don't try to decode an empty body (#631). (ec13c88f)

• FIX: don't try to decode an empty body (#631). (ec13c88f)

• FEAT(postgrest,supabase): add useSchema() method for making rest API calls on custom schema. (#525). (40a0f090)

• FIX: make Supabase client work in Dart Edge again (#675). (53530f22)
• FIX: Remove error parameter on _triggerChanError (#637). (c4291c97)
• FEAT: send messages via broadcast endpoint (#654). (2ff950d7)

• FIX: maybeSingle no longer logs error on Postgrest API (#564). (f6854e1d)
• FEAT(postgrest): updates for postgREST 11 (#550). (64d8eb59)

• FIX(postgrest): update docs to mention views (#543). (22eb68f2)

• REFACTOR: bump minimum Dart SDK version to 2.17.0 (#510). (ed927ee0)

• FIX: Update http dependency constraints (#491). (825d0737)

• FEAT: send messages via broadcast endpoint (#654). (2ff950d7)

2023-09-25

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• realtime_client - v1.2.3
• supabase - v1.11.6
• supabase_flutter - v1.10.19

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase - v1.11.6
• supabase_flutter - v1.10.19

• FIX(postgrest): Remove qoutations on foreign table transforms on 'or' (#477). (c2c6982a)
• FIX: Format the files to adjust to Flutter 3.10.1 (#475). (eb0bcd95)
• FEAT: update dependency constraints to sdk < 4.0.0 (#474). (7894bc70)

• chore: move the repo into supabase-flutter monorepo

• FIX: Remove error parameter on _triggerChanError (#637). (c4291c97)

2023-09-19

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• gotrue - v1.12.2
• postgrest - v1.5.1
• supabase - v1.11.5
• supabase_flutter - v1.10.18

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase_flutter - v1.10.18

• FIX(realtime_client): No exception is thrown when connection is closed. (#620). (64b8b968)

2023-09-05

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• gotrue - v1.12.1
• supabase - v1.11.3
• supabase_flutter - v1.10.16

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase - v1.11.3
• supabase_flutter - v1.10.16

• FIX(realtime_client,supabase): pass apikey as the initial access token for realtime client (#596). (af8e368b)

• FEAT: add logLevel parameter to RealtimeClientOptions (#592). (76e9fc20)

• REFACTOR: bump minimum Dart SDK version to 2.17.0 (#510). (ed927ee0)
• REFACTOR(realtime_client): Add docs on .subscribe() and give callback parameters names (#507). (7f9b310e)

• FIX: Format the files to adjust to Flutter 3.10.1 (#475). (eb0bcd95)
• FEAT: update dependency constraints to sdk < 4.0.0 (#474). (7894bc70)

• REFACTOR(supabase_common): share the local stack test configuration (#1640). (a08f06d3)

• FEAT(typegen): add supabase_typegen skeleton package (#1636). (91f26da0)

2026-07-15

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• functions_client - v2.7.0
• gotrue - v2.27.0
• postgrest - v2.9.0
• realtime_client - v2.12.0
• storage_client - v2.7.0
• supabase - v2.15.0
• supabase_common - v0.1.1
• supabase_flutter - v2.17.0
• supabase_lints - v0.1.1

• REFACTOR: share the test helpers through supabase_common (#1745). (bcb41fa4)
• REFACTOR: share the auth callback parameters and secure random helpers (#1744). (66ac4901)
• FEAT: introduce the supabase_testing package (#1747). (5a3aa9b4)
• BREAKING REFACTOR(storage): share one SortDirection enum across the packages (#1752). (38396ed5)
• BREAKING REFACTOR: rework logging to emit only through the supabase logger hierarchy (#1741). (d1642c80)
• BREAKING REFACTOR(storage): move the Iceberg catalog into its own package (#1711). (26fc503d)

2026-08-05

Changes

Packages with breaking changes:

• There are no breaking changes in this release.

Packages with other changes:

• gotrue - v2.27.1
• postgrest - v2.9.1
• realtime_client - v2.13.0
• storage_client - v2.8.0
• supabase - v2.16.0
• supabase_common - v0.1.2
• supabase_typegen - v0.1.1
• supabase_flutter - v2.17.1
• functions_client - v2.7.1

Packages with dependency updates only:

Packages listed below depend on other packages in this workspace that have had changes. Their versions have been incremented to bump the minimum dependency versions of the packages they depend upon in this project.

• supabase_flutter - v2.17.1
• functions_client - v2.7.1