supabase / supabase-flutter / 29415634238

87%

push

github

feat(functions): add request cancellation to invoke via abortSignal (#1593)

## Summary

Adds request cancellation to `FunctionsClient.invoke`, closing the gap
versus the canonical compliance matrix. `invoke` now accepts an optional
`abortSignal` Future; completing it cancels the in-flight HTTP request
and throws `RequestAbortedException`, mirroring how the database client
exposes cancellation through `PostgrestBuilder.abortSignal`.

This is done idiomatically with the `http` package's
`AbortableRequest`/`AbortableMultipartRequest` (wiring `abortTrigger`),
so it works for both regular and multipart invocations.
`RequestAbortedException` is re-exported from the package so callers can
catch it.

A per-invocation timeout is now expressible as `invoke(..., abortSignal:
Future.delayed(duration))`, so the previously `not_applicable`
`functions.invocation.timeout` note is updated accordingly.

## Outcome

**implemented**

## Reference

Mirrors the existing Dart
`database.using_modifiers.request_cancellation` idiom
(`PostgrestBuilder.abortSignal`).

## Compliance matrix

- `functions.invocation.request_cancellation` → **implemented** (symbol
`FunctionsClient.invoke` registered)

## Tests

- Aborting an in-flight request throws `RequestAbortedException`
- Aborting a multipart request throws `RequestAbortedException`
- A never-firing signal lets the request complete normally

SDK-1310

7 of 7 new or added lines in 1 file covered. (100.0%)

5090 of 5728 relevant lines covered (88.86%)

4.25 hits per line