refactor!: share one HttpMethod enum across the client packages

[spydon]

Tier 3 of #1572, second of four PRs. Stacked on #1644, so review that one first.

What

Four packages had four takes on the same enum:

Package	Before
postgrest	HttpMethod { get, head, post, put, patch, delete } with String get value
functions_client	HttpMethod { get, post, put, delete, patch }, callers did method.name.toUpperCase()
gotrue	RequestMethodType { get, post, put, patch, delete }
storage_client	raw 'GET' / 'POST' / 'HEAD' strings threaded through the fetch layer and the Iceberg catalog

All four now use one HttpMethod in supabase_common:

enum HttpMethod {
  get, head, post, put, patch, delete;

  /// The method as it appears on the wire, for example `GET`.
  String get value => name.toUpperCase();
}

The conflict this removes

supabase could not re-export both packages' enums, so it carried:

export 'package:postgrest/postgrest.dart' hide HttpMethod;

Both now resolve to the same declaration, so the hide is gone and HttpMethod is reachable from package:supabase and package:supabase_flutter for the first time (previously functions.invoke(method: ...) was usable from supabase_flutter only because functions_client's copy happened to win).

Breaking changes

• RequestMethodType is gone; gotrue's GotrueFetch.request takes HttpMethod. It lived in lib/src/ and was not exported from package:gotrue.
• functions_client's HttpMethod gains a head value and a value getter. Existing HttpMethod.post style usage is unaffected.
• postgrest's HttpMethod is unchanged in shape, it just moved packages.

Storage's changes are internal: its fetch layer and Iceberg REST catalog take HttpMethod instead of a String, which removes the last stringly-typed methods in the monorepo.

gotrue's request switch gained a head branch to stay exhaustive; it sends via Client.head like the other verbs.

Compliance matrix

functions.invocation.method_override listed the HttpMethod symbol. The enum now lives in the internal supabase_common, which is excluded from the public API scan, so the entry points at FunctionsClient.invoke (the method that actually takes the override) instead.

Testing

melos analyze and melos format clean. Full suites pass for gotrue, postgrest, storage_client, functions_client, realtime_client, supabase, supabase_common and supabase_flutter, plus the examples analyzer. The capability matrix symbol, drift and compliance checks pass.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 3ecdb6b7-0d17-48f4-b136-3caa225c76a2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}