Synheart Core - Swift SDK

https://github.com/synheart-ai/synheart-core-swift.git

dependencies: [
    .package(
        url: "https://github.com/synheart-ai/synheart-core-swift.git",
        from: "0.7.2"
    )
]

synheart install runtime --platform ios --version 0.46.0

<key>NSHealthShareUsageDescription</key>
<string>This app uses approved health data to provide private human-state insights.</string>

<key>NSMotionUsageDescription</key>
<string>This app uses motion data to improve state context and signal quality.</string>

Initialize → Grant consent → Activate features → Start → Observe → Stop

import Combine
import SynheartCore

final class HumanStateModel: ObservableObject {
    @Published private(set) var state: HSIState?
    private var cancellables = Set<AnyCancellable>()

    func start(subjectId: String) async throws {
        let config = SynheartConfig(
            appId: "com.example.myapp",
            subjectId: subjectId,
            appVersion: "1.0.0",
            appName: "My App",
            category: "wellness",
            developer: "Example, Inc.",
            allowUnsignedCapabilities: true
        )

        try await Synheart.initialize(
            config: config,
            userId: subjectId,
            autoStart: false
        )

        try await Synheart.grantConsent("biosignals")
        Synheart.activate(.wear)

        Synheart.onStateUpdate
            .receive(on: DispatchQueue.main)
            .sink { [weak self] in self?.state = $0 }
            .store(in: &cancellables)

        try await Synheart.startSession()
    }

    func stop() async throws {
        try await Synheart.stopSession()
    }

    func dispose() async throws {
        try await Synheart.dispose()
    }
}

let serviceOrigin = "https://api.synheart.ai"
let appId = "app_focus_ios_kB8mPx"  // platform app_id
let bundleId = "com.example.myapp"  // your bundle ID, checked by App Attest
let subjectId = "subject_7f8a..."
// Keep one id per installation; a new UUID on every launch looks like a new device.
let deviceId: String = {
    let key = "synheart.deviceId"
    if let saved = UserDefaults.standard.string(forKey: key) { return saved }
    let fresh = UUID().uuidString
    UserDefaults.standard.set(fresh, forKey: key)
    return fresh
}()

let config = SynheartConfig(
    appId: appId,
    subjectId: subjectId,
    appVersion: "1.0.0",
    appName: "My App",
    category: "wellness",
    developer: "Example, Inc.",
    deviceId: deviceId,
    storage: StorageConfig(enabled: true, retentionDays: 30),
    sync: SyncConfig(enabled: true, baseUrl: serviceOrigin),
    cloudConfig: CloudConfig(
        subjectId: subjectId,
        instanceId: deviceId,
        orgId: "org_example",
        baseUrl: serviceOrigin
    ),
    consentConfig: ConsentConfig(
        consentServiceUrl: serviceOrigin,
        appId: appId,
        deviceId: deviceId,
        userId: subjectId
    ),
    deviceAuthConfig: DeviceAuthConfig(
        authBaseUrl: serviceOrigin,
        packageName: bundleId
    )
)

_ = await Synheart.ensureDeviceAuthRegistered()
let consentReady = await Synheart.ensureCloudConsentReady()

if consentReady {
    Synheart.activate(.cloud)
}

try await Synheart.grantConsent("biosignals")
Synheart.activate(.wear)

// Revoke it later when requested by the user.
try await Synheart.revokeConsent("biosignals")

Synheart.onStateUpdate
    .sink { state in
        print(state.hsi.isEmpty ? "no evidence yet" : state.rawJson)
    }
    .store(in: &cancellables)

Synheart.onHSIUpdate
    .sink { rawJson in
        print(rawJson)
    }
    .store(in: &cancellables)

let queue = Synheart.uploadQueueStatus
let result = await Synheart.flushUploads(requireConsent: true)

print(queue)
print(result)

print(CoreRuntimeBridge.symbolDiagnostics)
print(CoreRuntimeBridge.dependencyDiagnostics)
print(Synheart.runtimeVersion ?? "unavailable")

for (module, reason) in Synheart.collectionStartupFailures {
    print("\(module): \(reason)")
}

do {
    try await Synheart.initialize(
        config: config,
        userId: subjectId,
        autoStart: false
    )
} catch let error as SynheartRuntimeError {
    // The linked runtime's C ABI or version doesn't fit this SDK.
    print("\(error.message)\nFix: \(error.installCommand)")
} catch SynheartError.runtimeIncompatible(let missingSymbols) {
    // No runtime is linked, or it lacks required symbols.
    print("Runtime mismatch: \(missingSymbols)")
} catch SynheartError.runtimeDependencyMissing(let dependencies) {
    print("Missing dependency: \(dependencies)")
} catch SynheartError.capabilityTokenRequired {
    print("Verified device authorization is required")
} catch {
    print(error.localizedDescription)
}