import Foundation import ScoreTrackerKit /// Idiomatic Swift facade over the Score Tracker KMP framework (#177). Wraps the /// generated `ScoreTrackerKit` Obj-C API with Swift types, sensible defaults, and /// `async`/`await`. Mirrors the web tracker's surface. The durable offline queue /// and persistent `anonymousId` are handled natively (NSUserDefaults) — see #176. public final class ScoreClient { private let tracker: ScoreTracker private var autoFlushTask: Task? /// - Parameters: /// - endpoint: middleware base URL; events POST to `/api/tracking/website`. /// - initialConsent: defaults to "none" — nothing fires until `setConsent(...)`. public init( publishableKey: String, siteId: String, endpoint: String, sdkVersion: String, appVersion: String? = nil, os: String? = nil, device: String? = nil, locale: String? = nil, initialConsent: ConsentState = ConsentState.companion.NONE ) { let config = TrackerConfig( publishableKey: publishableKey, siteId: siteId, endpoint: endpoint, sdk: SdkInfo(name: "@3halves-labs/score-tracker-ios", version: sdkVersion), device: DeviceDescriptor(os: os, device: device, appVersion: appVersion, locale: locale) ) tracker = IosPlatformKt.doNewScoreTracker(config: config, initialConsent: initialConsent) } // MARK: - Consent (wire to your CMP / OneTrust) public func setConsent(analytics: Bool, personalization: Bool, advertising: Bool) { tracker.setConsent(state: ConsentState(analytics: analytics, personalization: personalization, advertising: advertising)) } public func grantAllConsent() { tracker.setConsent(state: ConsentState.companion.ALL) } public func revokeConsent() { tracker.setConsent(state: ConsentState.companion.NONE) } // MARK: - Identity / Auth0 public func identify(userId: String, token: String? = nil) { tracker.identify(userId: userId, token: token) } public func setToken(_ token: String?) { tracker.setToken(token: token) } /// Provider is consulted before each flush — wire to your Auth0 access token. public func setTokenProvider(_ provider: @escaping () -> String?) { tracker.setTokenProvider(provider: provider) } public var anonymousId: String { tracker.anonymousId } public var pending: Int { Int(tracker.pending()) } // MARK: - Tracking /// Track an app event. Returns false if dropped by the consent gate. @discardableResult public func track(_ name: String, props: [String: Any] = [:]) -> Bool { tracker.track(name: name, props: props, type: .track, requires: [], delivery: .bestEffort) } /// Track an event gated on advertising consent (dropped until granted). @discardableResult public func trackAdvertising(_ name: String, props: [String: Any] = [:]) -> Bool { tracker.track(name: name, props: props, type: .track, requires: [ConsentCategory.advertising], delivery: .bestEffort) } /// Record an app-screen view. @discardableResult public func screen(_ name: String, props: [String: Any] = [:]) -> Bool { tracker.screen(name: name, props: props) } // MARK: - Flush /// Send the queued batch. Returns true on a 2xx ack. @discardableResult public func flush() async throws -> Bool { try await tracker.flush().boolValue } /// Call when the app returns to the foreground. public func onForeground() async throws { _ = try await tracker.onForeground() } /// Call when network connectivity is regained. public func onNetworkAvailable() async throws { _ = try await tracker.onNetworkAvailable() } public func shutdown() async throws { stopAutoFlush() try await tracker.shutdown() } // MARK: - Auto-flush (Swift-native; avoids passing a Kotlin CoroutineScope) public func startAutoFlush(everySeconds: Double = 30) { stopAutoFlush() autoFlushTask = Task { [weak self] in while !Task.isCancelled { try? await Task.sleep(nanoseconds: UInt64(everySeconds * 1_000_000_000)) _ = try? await self?.flush() } } } public func stopAutoFlush() { autoFlushTask?.cancel() autoFlushTask = nil } }