health_forge_core 0.1.1

Pure Dart core library for health_forge — unified models, enums, provider interfaces, and a configurable conflict resolution engine for multi-source health records.

health_forge_core

Pure Dart core library for Health Forge — a federated, zero-backend Flutter toolkit for aggregating health data from multiple providers into a unified data model.

This package has zero Flutter dependencies and is isolate-safe. It defines the shared data model, provider interfaces, and conflict resolution engine used by every other health_forge_* package.

What's inside

• 21 health record types across 6 families — activity, cardiovascular, sleep, recovery, respiratory, body
• 7 enums — MetricType, DataProvider, DataOrigin, ConflictStrategy, Freshness, AccessMode, SyncModel
• Envelope mixin — HealthRecordMixin (id, provider, timestamps, provenance, extensions) on every record
• Provider interfaces — HealthProvider, ProviderCapabilities, AuthResult, AuthStatus
• MergeEngine — 5 conflict resolution strategies: priority-based, keep-all, average, most-granular, custom
• DuplicateDetector — clusters overlapping records per MetricType using a configurable timeOverlapThresholdSeconds
• Provider extensions — type-safe registry for provider-specific metrics (OuraSleepExtension, StravaWorkoutExtension, GarminSleepExtension)

Installation

dependencies:
  health_forge_core: ^0.1.1

You typically won't depend on this package directly — use health_forge (Flutter client) plus the provider adapters you need.

Usage

import 'package:health_forge_core/health_forge_core.dart';

final engine = MergeEngine(
  config: const MergeConfig(
    defaultStrategy: ConflictStrategy.priorityBased,
    providerPriority: [DataProvider.oura, DataProvider.apple],
  ),
);

final merged = engine.merge(records);
for (final record in merged.records) {
  print('${record.provider}: ${record.providerRecordType}');
}

Related packages

Package	Purpose
health_forge	Flutter client (registry, auth, queries, cache)
health_forge_apple	Apple HealthKit adapter
health_forge_ghc	Google Health Connect adapter
health_forge_oura	Oura Ring REST API adapter
health_forge_strava	Strava REST API adapter

Documentation

• Getting started guide
• Architecture decision records

License

MIT