bifrosted

Breaking: replaced the shipped BifrostTestEnv service graph with BifrostTestRuntime. Test setup now resets only Bifrost's transport, preferences, clock, decoder, performance tracker, fake mode, notifications, and internal diagnostics. It never replaces bifrostServiceLocator; apps rebuild their own production container through initializeApplication.

BifrostTestRuntime.install(
  responseFactory: (_) => const <Object>[],
  notifications: notifications,
  diagnostics: diagnostics,
  initializeApplication: AppBinding.reinitialize,
);

responseFactory, shouldFail, and responder now share the same per-request responder seam, so overrides reach HTTP clients retained by vendor SDKs such as Supabase. Notification tests record outcomes without replacing the app's real SystemNotifier registration.

Added non-recoverable FailureReason.internal. Unexpected defects thrown by source adapters, REST hooks, or repository callbacks no longer masquerade as network and get rescued by stale cache. fetch and mutate return an internal failure; the source-compatible boolean send returns false and records an internal diagnostic. Internal failures never invoke SystemNotifier.

RestAPI now bounds header resolution, each HTTP attempt, and unauthorized refresh. Override requestTimeout or refreshTimeout for API-specific budgets. Operational ClientException and timeout failures still return null; unexpected hook/client defects preserve their original error and stack in BifrostInternalException for repository containment. Timed-out refreshes remain single-flight until the underlying refresh actually ends.

Serialized the complete cache save, per-key clear, and clear-all mutations behind one failure-resilient queue shared by every repository instance. Two concurrent reads can no longer lose a registry entry and leave cached payloads that clearAllCache() cannot enumerate.

Added postgrestErrorResponse to package:bifrosted/testing.dart. It builds a complete PostgREST error envelope for tests that exercise a real retained Supabase/PostgREST client; production SQLSTATE/PGRST mapping remains app-owned.

Simplified Bifrost's private package test fixture: its locator is installed once per test file while its mutable services still reset before every test.

Breaking: BifrostTestEnv.reset() no longer assigns bifrostServiceLocator. It was a second dependency-injection system running against the app's own. An app's bindings already point the locator at its container, so reset() and those bindings overwrote each other and which one won depended on call order — a repository test that ran reset() last silently stopped resolving the services its production code uses, while a widget test resolved them normally. Tests should exercise the same injection production does.

Register the doubles through the app's own container instead:

bifrostTestEnv.reset();
Bind.delete<SystemNotifier>(force: true);   // GetX keeps the first permanent registration
Bind.put<SystemNotifier>(bifrostTestEnv.notifier, permanent: true);

A package with no container of its own — bifrosted included — can call bifrostTestEnv.installDoubles(), which does what reset() used to. It is documented as exactly that: a shim for the no-DI case, not something an app should reach for.

Migration: if your tests broke with "…" not found after upgrading, add installDoubles() after reset() to restore the old behaviour, then move to container registration when convenient.

Fixed: RestAPI.host rejected any value containing a colon. _buildUri passed host straight into Uri(scheme: 'https', host: host), and Uri's host parameter reads a colon as an IPv6 literal — so a scheme-qualified URL, a port, and therefore any local dev server threw FormatException: Illegal IPv6 address, invalid character (at character 1), an error naming none of the actual causes.

host now accepts what you'd reasonably put in a config value:

Backward compatible: a bare hostname still resolves to https.

An empty host now throws ArgumentError naming the likely cause — an app launched without --dart-define-from-file — instead of silently building https:///path and failing at the transport layer.

bifrostLogger = Logger(
  level: kReleaseMode ? Level.warning : Level.debug,
  filter: ProductionFilter(),   // required; DevelopmentFilter ignores `level`
);

useMockStorage();                                   // clean slate
useMockStorage(values: {'onboarding_done': true});  // seeded state

• onNetworkError(), onUnauthorized(), onRequestFailed({statusCode, body})
• Removed onForbidden, onServerError, onApiError

// At app startup:
bifrostServiceLocator = <T>() => Get.find<T>();

class UserRepo extends BifrostRepository {
  Future<User?> getUser(String id) => fetch<User>(...);
}

• useMockClient() - Enable mock responses for all RestAPI instances
• useRealClient() - Reset to real HTTP clients
• setClientFactory() - Set custom client factory
• No more per-API client overrides needed

• Changed build_to: cache and build_extensions: .fake.g.part
• Generator output now properly merges with json_serializable/freezed

• No manual configuration needed - just add the dependency and run build_runner
• Works like freezed/json_serializable out of the box

• fakeForKey(String key) - generates fake data based on field name
• create<T>() - generates fake model from factory
• fakeJson() / fakeJsonList() - generic JSON generators

• Generates .fake() extension methods for annotated classes
• Works with freezed models

• GET, POST, PUT, PATCH, DELETE methods
• Automatic error handling and logging
• Header management with extra headers support

• fetch<T>() and fetchList<T>() for automatic deserialization
• Offline-first with cache fallback
• Automatic cache expiration

• onNetworkError(), onUnauthorized(), onForbidden()
• onServerError(), onApiError()