feat(app): add resilient Flow recovery and privacy-safe analytics

Unify PiP recovery across startup and foreground transitions, surface actionable status, and add privacy-safe analytics plus the refreshed onboarding and account experience. Update documentation assets and advance the release build to 84.

OSGKeyboardExt/Services/AnalyticsExtensionService.swift

@@ -0,0 +1,110 @@
+// AnalyticsExtensionService.swift
+// OSGKeyboard · Keyboard Extension
+//
+// The extension records into the shared SQLite queue and only attempts one
+// short anonymous batch when Full Access permits network use.
+
+import Foundation
+import OSGKeyboardShared
+import OSLog
+
+private actor ExtensionAnalyticsUploadSignal: AnalyticsUploadTriggering {
+    typealias Action = @Sendable () async -> Void
+
+    private var action: Action?
+    private var canUpload = false
+    private var isUploading = false
+
+    func install(_ action: @escaping Action) {
+        self.action = action
+    }
+
+    func setCanUpload(_ canUpload: Bool) {
+        self.canUpload = canUpload
+    }
+
+    func requestUpload() {
+        guard canUpload, !isUploading, let action else { return }
+        isUploading = true
+        Task {
+            await action()
+            uploadFinished()
+        }
+    }
+
+    private func uploadFinished() {
+        isUploading = false
+    }
+}
+
+private struct ExtensionAnalyticsLogger: AnalyticsLogging {
+    private let logger = Logger(
+        subsystem: Bundle.main.bundleIdentifier ?? "com.osgkeyboard.ios.keyboard",
+        category: "analytics"
+    )
+
+    func log(_ entry: AnalyticsUploadLogEntry) {
+        let statusCode = entry.statusCode ?? 0
+        let errorCategory = entry.errorCategory?.rawValue ?? "none"
+        logger.info(
+            "outcome=\(entry.outcome.rawValue, privacy: .public) count=\(entry.eventCount, privacy: .public) status=\(statusCode, privacy: .public) attempt=\(entry.attempt, privacy: .public) error=\(errorCategory, privacy: .public)"
+        )
+    }
+}
+
+final class AnalyticsExtensionService: Sendable {
+    static let shared = AnalyticsExtensionService()
+
+    let client: any AnalyticsClient
+
+    private let runtime: AnalyticsRuntime
+    private let uploadSignal: ExtensionAnalyticsUploadSignal
+
+    private init() {
+        let signal = ExtensionAnalyticsUploadSignal()
+        uploadSignal = signal
+        let runtime = AnalyticsRuntime.keyboardExtension(
+            environment: Self.environment,
+            uploadConfiguration: AnalyticsUploadConfiguration(endpoint: Self.endpoint),
+            trigger: signal,
+            logger: ExtensionAnalyticsLogger()
+        )
+        self.runtime = runtime
+        client = runtime.client
+
+        Task {
+            await signal.install {
+                await runtime.uploadCoordinator.uploadAvailableEvents(maximumBatches: 1)
+            }
+        }
+    }
+
+    func recordPresentation(hasFullAccess: Bool) {
+        Task {
+            await uploadSignal.setCanUpload(hasFullAccess)
+            client.recordSessionActivity()
+            client.recordKeyboardActivated()
+        }
+    }
+
+    func keyboardWillDisappear() {
+        Task {
+            await uploadSignal.setCanUpload(false)
+        }
+    }
+
+    private static let endpoint = URL(
+        string: "https://account.osglab.com/v1/analytics/events"
+    )!
+
+    private static var environment: AnalyticsEnvironment {
+        let appVersion = Bundle.main.object(
+            forInfoDictionaryKey: "CFBundleShortVersionString"
+        ) as? String ?? "unknown"
+        let version = ProcessInfo.processInfo.operatingSystemVersion
+        return AnalyticsEnvironment(
+            appVersion: appVersion,
+            osVersion: "\(version.majorVersion).\(version.minorVersion).\(version.patchVersion)"
+        )
+    }
+}