Login API

import com.meta.horizon.platform.sdk.users.Users
import kotlinx.coroutines.launch

// Somewhere in your login UI handler
onLoginWithHorizon = {
  coroutineScope.launch {
    val users = Users()

    // Example only (do NOT hardcode in production):
    // https://partner.example.com/device?code=ABC123
    //
    // The user_code is effectively a nonce and must be generated server-side
    // per login attempt (RFC 8628 S3.2).
    val authUrl = getAuthUrlWithUserCode()

    val intent = users.send_auth_url(authUrl)

    activityLauncher?.launch(intent)
      ?: error("Activity launcher not initialized")
  }
}

/**
 * 3P-defined helper that fetches a freshly-generated device/user code from the 3P backend
 * and returns the full verification URL to show to the user.
 *
 * RFC 8628 S3.2: https://datatracker.ietf.org/doc/html/rfc8628#section-3.2
 */
suspend fun getAuthUrlWithUserCode(): String {
  val response: DeviceCodeResponse = fetchDeviceCodeFrom3PBackend()
  return "${response.verification_uri}?code=${response.user_code}"
}

// Example response shape (align to whatever your backend returns).
data class DeviceCodeResponse(
  val verification_uri: String,
  val user_code: String,
)

/**
 * Replace this with your real network call to your 3P backend service.
 * This is intentionally not implemented in the sample.
 */
suspend fun fetchDeviceCodeFrom3PBackend(): DeviceCodeResponse {
  TODO("Call your 3P backend to generate user_code/device_code and return verification_uri + user_code")
}

<manifest xmlns:horizonos="http://schemas.horizonos/sdk">
  <horizonos:uses-horizonos-sdk
      horizonos:minSdkVersion="83"
      horizonos:targetSdkVersion="83" />
  ...
</manifest>