Synheart Behavior — Swift / iOS SDK

​

Overview

​

Installation

​

Swift Package Manager

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

​

Requirements

• iOS 12.0+
• Swift 5.0+
• Xcode 12.0+

​

Quick Start

import SynheartBehavior

let config = BehaviorConfig(
    enableInputSignals: true,
    enableAttentionSignals: true,
    enableMotionLite: false,
    consentBehavior: true
)

let behavior = SynheartBehavior(config: config)
try behavior.initialize()

// Real-time event stream
behavior.setEventHandler { event in
    print("Event: \(event.type) at \(event.timestamp)")
}

// Start a session
let sessionId = try behavior.startSession()

// ... user interacts with app ...

let summary = try behavior.endSession(sessionId: sessionId)
print("Total events: \(summary.totalEvents)")
print("Typing speed: \(summary.typingSessionSummary?.typingSpeed ?? 0)")

​

Typing: clipboard and correction rates

• Backspace/correction: Inferred from text length decrease. Cut is not counted as backspace.
• Copy/paste/cut: The SDK does not observe the system clipboard. Call:
  • behavior.recordCopy()
  • behavior.recordPaste()
  • behavior.recordCut()
  when the user performs those actions (e.g. from a custom UITextField/UITextView that overrides copy(_:), paste(_:), cut(_:)). The Example app uses BehaviorTrackingTextField for this.

​

Event behavior

• Taps and long press: Not counted when a text field or text view is first responder (keyboard open), so typing is not double-counted as taps.
• Typing events: Include speed, cadence, burstiness, cadence variability, gap ratio, activity ratio, and backspace/copy/paste/cut counts.

​

API summary

​

Resources

• Repository: synheart-behavior-swift