// This file was autogenerated by some hot garbage in the `uniffi` crate.
// Trust me, you don't want to mess with it!

@file:Suppress("NAME_SHADOWING")

package mozilla.appservices.relay

// Common helper code.
//
// Ideally this would live in a separate .kt file where it can be unittested etc
// in isolation, and perhaps even published as a re-useable package.
//
// However, it's important that the details of how this helper code works (e.g. the
// way that different builtin types are passed across the FFI) exactly match what's
// expected by the Rust code on the other side of the interface. In practice right
// now that means coming from the exact some version of `uniffi` that was used to
// compile the Rust component. The easiest way to ensure this is to bundle the Kotlin
// helpers directly inline like we're doing here.

import com.sun.jna.Library
import com.sun.jna.IntegerType
import com.sun.jna.Native
import com.sun.jna.Pointer
import com.sun.jna.Structure
import com.sun.jna.Callback
import com.sun.jna.ptr.*
import java.nio.ByteBuffer
import java.nio.ByteOrder
import java.nio.CharBuffer
import java.nio.charset.CodingErrorAction
import java.util.concurrent.atomic.AtomicLong
import java.util.concurrent.ConcurrentHashMap
import java.util.concurrent.atomic.AtomicBoolean
import mozilla.appservices.remotesettings.FfiConverterTypeRemoteSettingsService
import mozilla.appservices.remotesettings.RemoteSettingsService
import mozilla.appservices.remotesettings.RustBuffer as RustBufferRemoteSettingsService

// This is a helper for safely working with byte buffers returned from the Rust code.
// A rust-owned buffer is represented by its capacity, its current length, and a
// pointer to the underlying data.

/**
 * @suppress
 */
@Structure.FieldOrder("capacity", "len", "data")
open class RustBuffer : Structure() {
    // Note: `capacity` and `len` are actually `ULong` values, but JVM only supports signed values.
    // When dealing with these fields, make sure to call `toULong()`.
    @JvmField var capacity: Long = 0
    @JvmField var len: Long = 0
    @JvmField var data: Pointer? = null

    class ByValue: RustBuffer(), Structure.ByValue
    class ByReference: RustBuffer(), Structure.ByReference

   internal fun setValue(other: RustBuffer) {
        capacity = other.capacity
        len = other.len
        data = other.data
    }

    companion object {
        internal fun alloc(size: ULong = 0UL) = uniffiRustCall() { status ->
            // Note: need to convert the size to a `Long` value to make this work with JVM.
            UniffiLib.ffi_relay_rustbuffer_alloc(size.toLong(), status)
        }.also {
            if(it.data == null) {
               throw RuntimeException("RustBuffer.alloc() returned null data pointer (size=${size})")
           }
        }

        internal fun create(capacity: ULong, len: ULong, data: Pointer?): RustBuffer.ByValue {
            var buf = RustBuffer.ByValue()
            buf.capacity = capacity.toLong()
            buf.len = len.toLong()
            buf.data = data
            return buf
        }

        internal fun free(buf: RustBuffer.ByValue) = uniffiRustCall() { status ->
            UniffiLib.ffi_relay_rustbuffer_free(buf, status)
        }
    }

    @Suppress("TooGenericExceptionThrown")
    fun asByteBuffer() =
        this.data?.getByteBuffer(0, this.len)?.also {
            it.order(ByteOrder.BIG_ENDIAN)
        }
}

// This is a helper for safely passing byte references into the rust code.
// It's not actually used at the moment, because there aren't many things that you
// can take a direct pointer to in the JVM, and if we're going to copy something
// then we might as well copy it into a `RustBuffer`. But it's here for API
// completeness.

@Structure.FieldOrder("len", "data")
internal open class ForeignBytes : Structure() {
    @JvmField var len: Int = 0
    @JvmField var data: Pointer? = null

    class ByValue : ForeignBytes(), Structure.ByValue
}
/**
 * The FfiConverter interface handles converter types to and from the FFI
 *
 * All implementing objects should be public to support external types.  When a
 * type is external we need to import it's FfiConverter.
 *
 * @suppress
 */
public interface FfiConverter<KotlinType, FfiType> {
    // Convert an FFI type to a Kotlin type
    fun lift(value: FfiType): KotlinType

    // Convert an Kotlin type to an FFI type
    fun lower(value: KotlinType): FfiType

    // Read a Kotlin type from a `ByteBuffer`
    fun read(buf: ByteBuffer): KotlinType

    // Calculate bytes to allocate when creating a `RustBuffer`
    //
    // This must return at least as many bytes as the write() function will
    // write. It can return more bytes than needed, for example when writing
    // Strings we can't know the exact bytes needed until we the UTF-8
    // encoding, so we pessimistically allocate the largest size possible (3
    // bytes per codepoint).  Allocating extra bytes is not really a big deal
    // because the `RustBuffer` is short-lived.
    fun allocationSize(value: KotlinType): ULong

    // Write a Kotlin type to a `ByteBuffer`
    fun write(value: KotlinType, buf: ByteBuffer)

    // Lower a value into a `RustBuffer`
    //
    // This method lowers a value into a `RustBuffer` rather than the normal
    // FfiType.  It's used by the callback interface code.  Callback interface
    // returns are always serialized into a `RustBuffer` regardless of their
    // normal FFI type.
    fun lowerIntoRustBuffer(value: KotlinType): RustBuffer.ByValue {
        val rbuf = RustBuffer.alloc(allocationSize(value))
        try {
            val bbuf = rbuf.data!!.getByteBuffer(0, rbuf.capacity).also {
                it.order(ByteOrder.BIG_ENDIAN)
            }
            write(value, bbuf)
            rbuf.writeField("len", bbuf.position().toLong())
            return rbuf
        } catch (e: Throwable) {
            RustBuffer.free(rbuf)
            throw e
        }
    }

    // Lift a value from a `RustBuffer`.
    //
    // This here mostly because of the symmetry with `lowerIntoRustBuffer()`.
    // It's currently only used by the `FfiConverterRustBuffer` class below.
    fun liftFromRustBuffer(rbuf: RustBuffer.ByValue): KotlinType {
        val byteBuf = rbuf.asByteBuffer()!!
        try {
           val item = read(byteBuf)
           if (byteBuf.hasRemaining()) {
               throw RuntimeException("junk remaining in buffer after lifting, something is very wrong!!")
           }
           return item
        } finally {
            RustBuffer.free(rbuf)
        }
    }
}

/**
 * FfiConverter that uses `RustBuffer` as the FfiType
 *
 * @suppress
 */
public interface FfiConverterRustBuffer<KotlinType>: FfiConverter<KotlinType, RustBuffer.ByValue> {
    override fun lift(value: RustBuffer.ByValue) = liftFromRustBuffer(value)
    override fun lower(value: KotlinType) = lowerIntoRustBuffer(value)
}
// A handful of classes and functions to support the generated data structures.
// This would be a good candidate for isolating in its own ffi-support lib.

internal const val UNIFFI_CALL_SUCCESS = 0.toByte()
internal const val UNIFFI_CALL_ERROR = 1.toByte()
internal const val UNIFFI_CALL_UNEXPECTED_ERROR = 2.toByte()

@Structure.FieldOrder("code", "error_buf")
internal open class UniffiRustCallStatus : Structure() {
    @JvmField var code: Byte = 0
    @JvmField var error_buf: RustBuffer.ByValue = RustBuffer.ByValue()

    class ByValue: UniffiRustCallStatus(), Structure.ByValue

    fun isSuccess(): Boolean {
        return code == UNIFFI_CALL_SUCCESS
    }

    fun isError(): Boolean {
        return code == UNIFFI_CALL_ERROR
    }

    fun isPanic(): Boolean {
        return code == UNIFFI_CALL_UNEXPECTED_ERROR
    }

    companion object {
        fun create(code: Byte, errorBuf: RustBuffer.ByValue): UniffiRustCallStatus.ByValue {
            val callStatus = UniffiRustCallStatus.ByValue()
            callStatus.code = code
            callStatus.error_buf = errorBuf
            return callStatus
        }
    }
}

class InternalException(message: String) : kotlin.Exception(message)

/**
 * Each top-level error class has a companion object that can lift the error from the call status's rust buffer
 *
 * @suppress
 */
interface UniffiRustCallStatusErrorHandler<E> {
    fun lift(error_buf: RustBuffer.ByValue): E;
}

// Helpers for calling Rust
// In practice we usually need to be synchronized to call this safely, so it doesn't
// synchronize itself

// Call a rust function that returns a Result<>.  Pass in the Error class companion that corresponds to the Err
private inline fun <U, E: kotlin.Exception> uniffiRustCallWithError(errorHandler: UniffiRustCallStatusErrorHandler<E>, callback: (UniffiRustCallStatus) -> U): U {
    var status = UniffiRustCallStatus()
    val return_value = callback(status)
    uniffiCheckCallStatus(errorHandler, status)
    return return_value
}

// Check UniffiRustCallStatus and throw an error if the call wasn't successful
private fun<E: kotlin.Exception> uniffiCheckCallStatus(errorHandler: UniffiRustCallStatusErrorHandler<E>, status: UniffiRustCallStatus) {
    if (status.isSuccess()) {
        return
    } else if (status.isError()) {
        throw errorHandler.lift(status.error_buf)
    } else if (status.isPanic()) {
        // when the rust code sees a panic, it tries to construct a rustbuffer
        // with the message.  but if that code panics, then it just sends back
        // an empty buffer.
        if (status.error_buf.len > 0) {
            throw InternalException(FfiConverterString.lift(status.error_buf))
        } else {
            throw InternalException("Rust panic")
        }
    } else {
        throw InternalException("Unknown rust call status: $status.code")
    }
}

/**
 * UniffiRustCallStatusErrorHandler implementation for times when we don't expect a CALL_ERROR
 *
 * @suppress
 */
object UniffiNullRustCallStatusErrorHandler: UniffiRustCallStatusErrorHandler<InternalException> {
    override fun lift(error_buf: RustBuffer.ByValue): InternalException {
        RustBuffer.free(error_buf)
        return InternalException("Unexpected CALL_ERROR")
    }
}

// Call a rust function that returns a plain value
private inline fun <U> uniffiRustCall(callback: (UniffiRustCallStatus) -> U): U {
    return uniffiRustCallWithError(UniffiNullRustCallStatusErrorHandler, callback)
}

internal inline fun<T> uniffiTraitInterfaceCall(
    callStatus: UniffiRustCallStatus,
    makeCall: () -> T,
    writeReturn: (T) -> Unit,
) {
    try {
        writeReturn(makeCall())
    } catch(e: kotlin.Exception) {
        val err = try { e.stackTraceToString() } catch(_: Throwable) { "" }
        callStatus.code = UNIFFI_CALL_UNEXPECTED_ERROR
        callStatus.error_buf = FfiConverterString.lower(err)
    }
}

internal inline fun<T, reified E: Throwable> uniffiTraitInterfaceCallWithError(
    callStatus: UniffiRustCallStatus,
    makeCall: () -> T,
    writeReturn: (T) -> Unit,
    lowerError: (E) -> RustBuffer.ByValue
) {
    try {
        writeReturn(makeCall())
    } catch(e: kotlin.Exception) {
        if (e is E) {
            callStatus.code = UNIFFI_CALL_ERROR
            callStatus.error_buf = lowerError(e)
        } else {
            val err = try { e.stackTraceToString() } catch(_: Throwable) { "" }
            callStatus.code = UNIFFI_CALL_UNEXPECTED_ERROR
            callStatus.error_buf = FfiConverterString.lower(err)
        }
    }
}
// Initial value and increment amount for handles. 
// These ensure that Kotlin-generated handles always have the lowest bit set
private const val UNIFFI_HANDLEMAP_INITIAL = 1.toLong()
private const val UNIFFI_HANDLEMAP_DELTA = 2.toLong()

// Map handles to objects
//
// This is used pass an opaque 64-bit handle representing a foreign object to the Rust code.
internal class UniffiHandleMap<T: Any> {
    private val map = ConcurrentHashMap<Long, T>()
    // Start 
    private val counter = java.util.concurrent.atomic.AtomicLong(UNIFFI_HANDLEMAP_INITIAL)

    val size: Int
        get() = map.size

    // Insert a new object into the handle map and get a handle for it
    fun insert(obj: T): Long {
        val handle = counter.getAndAdd(UNIFFI_HANDLEMAP_DELTA)
        map.put(handle, obj)
        return handle
    }

    // Clone a handle, creating a new one
    fun clone(handle: Long): Long {
        val obj = map.get(handle) ?: throw InternalException("UniffiHandleMap.clone: Invalid handle")
        return insert(obj)
    }

    // Get an object from the handle map
    fun get(handle: Long): T {
        return map.get(handle) ?: throw InternalException("UniffiHandleMap.get: Invalid handle")
    }

    // Remove an entry from the handlemap and get the Kotlin object back
    fun remove(handle: Long): T {
        return map.remove(handle) ?: throw InternalException("UniffiHandleMap: Invalid handle")
    }
}

// Contains loading, initialization code,
// and the FFI Function declarations in a com.sun.jna.Library.
@Synchronized
private fun findLibraryName(componentName: String): String {
    val libOverride = System.getProperty("uniffi.component.$componentName.libraryOverride")
    if (libOverride != null) {
        return libOverride
    }
    return "megazord"
}

// Define FFI callback types
internal interface UniffiRustFutureContinuationCallback : com.sun.jna.Callback {
    fun callback(`data`: Long,`pollResult`: Byte,)
}
internal interface UniffiForeignFutureDroppedCallback : com.sun.jna.Callback {
    fun callback(`handle`: Long,)
}
internal interface UniffiCallbackInterfaceFree : com.sun.jna.Callback {
    fun callback(`handle`: Long,)
}
internal interface UniffiCallbackInterfaceClone : com.sun.jna.Callback {
    fun callback(`handle`: Long,)
    : Long
}
@Structure.FieldOrder("handle", "free")
internal open class UniffiForeignFutureDroppedCallbackStruct(
    @JvmField internal var `handle`: Long = 0.toLong(),
    @JvmField internal var `free`: UniffiForeignFutureDroppedCallback? = null,
) : Structure() {
    class UniffiByValue(
        `handle`: Long = 0.toLong(),
        `free`: UniffiForeignFutureDroppedCallback? = null,
    ): UniffiForeignFutureDroppedCallbackStruct(`handle`,`free`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureDroppedCallbackStruct) {
        `handle` = other.`handle`
        `free` = other.`free`
    }

}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultU8(
    @JvmField internal var `returnValue`: Byte = 0.toByte(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Byte = 0.toByte(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultU8(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultU8) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteU8 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultU8.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultI8(
    @JvmField internal var `returnValue`: Byte = 0.toByte(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Byte = 0.toByte(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultI8(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultI8) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteI8 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultI8.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultU16(
    @JvmField internal var `returnValue`: Short = 0.toShort(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Short = 0.toShort(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultU16(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultU16) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteU16 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultU16.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultI16(
    @JvmField internal var `returnValue`: Short = 0.toShort(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Short = 0.toShort(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultI16(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultI16) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteI16 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultI16.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultU32(
    @JvmField internal var `returnValue`: Int = 0,
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Int = 0,
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultU32(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultU32) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteU32 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultU32.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultI32(
    @JvmField internal var `returnValue`: Int = 0,
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Int = 0,
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultI32(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultI32) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteI32 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultI32.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultU64(
    @JvmField internal var `returnValue`: Long = 0.toLong(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Long = 0.toLong(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultU64(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultU64) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteU64 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultU64.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultI64(
    @JvmField internal var `returnValue`: Long = 0.toLong(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Long = 0.toLong(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultI64(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultI64) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteI64 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultI64.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultF32(
    @JvmField internal var `returnValue`: Float = 0.0f,
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Float = 0.0f,
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultF32(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultF32) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteF32 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultF32.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultF64(
    @JvmField internal var `returnValue`: Double = 0.0,
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: Double = 0.0,
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultF64(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultF64) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteF64 : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultF64.UniffiByValue,)
}
@Structure.FieldOrder("returnValue", "callStatus")
internal open class UniffiForeignFutureResultRustBuffer(
    @JvmField internal var `returnValue`: RustBuffer.ByValue = RustBuffer.ByValue(),
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `returnValue`: RustBuffer.ByValue = RustBuffer.ByValue(),
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultRustBuffer(`returnValue`,`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultRustBuffer) {
        `returnValue` = other.`returnValue`
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteRustBuffer : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultRustBuffer.UniffiByValue,)
}
@Structure.FieldOrder("callStatus")
internal open class UniffiForeignFutureResultVoid(
    @JvmField internal var `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
) : Structure() {
    class UniffiByValue(
        `callStatus`: UniffiRustCallStatus.ByValue = UniffiRustCallStatus.ByValue(),
    ): UniffiForeignFutureResultVoid(`callStatus`,), Structure.ByValue

   internal fun uniffiSetValue(other: UniffiForeignFutureResultVoid) {
        `callStatus` = other.`callStatus`
    }

}
internal interface UniffiForeignFutureCompleteVoid : com.sun.jna.Callback {
    fun callback(`callbackData`: Long,`result`: UniffiForeignFutureResultVoid.UniffiByValue,)
}

// A JNA Library to expose the extern-C FFI definitions.
// This is an implementation detail which will be called internally by the public API.

// For large crates we prevent `MethodTooLargeException` (see #2340)
// N.B. the name of the extension is very misleading, since it is
// rather `InterfaceTooLargeException`, caused by too many methods
// in the interface for large crates.
//
// By splitting the otherwise huge interface into two parts
// * UniffiLib (this)
// * IntegrityCheckingUniffiLib
// And all checksum methods are put into `IntegrityCheckingUniffiLib`
// we allow for ~2x as many methods in the UniffiLib interface.
//
// Note: above all written when we used JNA's `loadIndirect` etc.
// We now use JNA's "direct mapping" - unclear if same considerations apply exactly.
internal object IntegrityCheckingUniffiLib {
    init {
        Native.register(IntegrityCheckingUniffiLib::class.java, findLibraryName(componentName = "relay"))
        uniffiCheckContractApiVersion(this)
    }
    external fun uniffi_relay_checksum_method_relayclient_accept_terms(
    ): Short
    external fun uniffi_relay_checksum_method_relayclient_create_address(
    ): Short
    external fun uniffi_relay_checksum_method_relayclient_fetch_addresses(
    ): Short
    external fun uniffi_relay_checksum_method_relayclient_fetch_profile(
    ): Short
    external fun uniffi_relay_checksum_method_relayremotesettingsclient_should_show_relay(
    ): Short
    external fun uniffi_relay_checksum_constructor_relayclient_new(
    ): Short
    external fun uniffi_relay_checksum_constructor_relayremotesettingsclient_new(
    ): Short
    external fun ffi_relay_uniffi_contract_version(
    ): Int

        
}

internal object UniffiLib {
    
    // The Cleaner for the whole library
    internal val CLEANER: UniffiCleaner by lazy {
        UniffiCleaner.create()
    }
    

    init {
        Native.register(UniffiLib::class.java, findLibraryName(componentName = "relay"))
        mozilla.appservices.remotesettings.uniffiEnsureInitialized()
        
    }
    external fun uniffi_relay_fn_clone_relayclient(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun uniffi_relay_fn_free_relayclient(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Unit
    external fun uniffi_relay_fn_constructor_relayclient_new(`serverUrl`: RustBuffer.ByValue,`authToken`: RustBuffer.ByValue,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun uniffi_relay_fn_method_relayclient_accept_terms(`ptr`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Unit
    external fun uniffi_relay_fn_method_relayclient_create_address(`ptr`: Long,`description`: RustBuffer.ByValue,`generatedFor`: RustBuffer.ByValue,`usedOn`: RustBuffer.ByValue,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun uniffi_relay_fn_method_relayclient_fetch_addresses(`ptr`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun uniffi_relay_fn_method_relayclient_fetch_profile(`ptr`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun uniffi_relay_fn_clone_relayremotesettingsclient(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun uniffi_relay_fn_free_relayremotesettingsclient(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Unit
    external fun uniffi_relay_fn_constructor_relayremotesettingsclient_new(`rsService`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun uniffi_relay_fn_method_relayremotesettingsclient_should_show_relay(`ptr`: Long,`host`: RustBuffer.ByValue,`domain`: RustBuffer.ByValue,`isRelayUser`: Byte,uniffi_out_err: UniffiRustCallStatus, 
    ): Byte
    external fun ffi_relay_rustbuffer_alloc(`size`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun ffi_relay_rustbuffer_from_bytes(`bytes`: ForeignBytes.ByValue,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun ffi_relay_rustbuffer_free(`buf`: RustBuffer.ByValue,uniffi_out_err: UniffiRustCallStatus, 
    ): Unit
    external fun ffi_relay_rustbuffer_reserve(`buf`: RustBuffer.ByValue,`additional`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun ffi_relay_rust_future_poll_u8(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_u8(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_u8(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_u8(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Byte
    external fun ffi_relay_rust_future_poll_i8(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_i8(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_i8(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_i8(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Byte
    external fun ffi_relay_rust_future_poll_u16(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_u16(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_u16(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_u16(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Short
    external fun ffi_relay_rust_future_poll_i16(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_i16(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_i16(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_i16(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Short
    external fun ffi_relay_rust_future_poll_u32(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_u32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_u32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_u32(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Int
    external fun ffi_relay_rust_future_poll_i32(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_i32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_i32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_i32(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Int
    external fun ffi_relay_rust_future_poll_u64(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_u64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_u64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_u64(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun ffi_relay_rust_future_poll_i64(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_i64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_i64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_i64(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Long
    external fun ffi_relay_rust_future_poll_f32(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_f32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_f32(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_f32(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Float
    external fun ffi_relay_rust_future_poll_f64(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_f64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_f64(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_f64(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Double
    external fun ffi_relay_rust_future_poll_rust_buffer(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_rust_buffer(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_rust_buffer(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_rust_buffer(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): RustBuffer.ByValue
    external fun ffi_relay_rust_future_poll_void(`handle`: Long,`callback`: UniffiRustFutureContinuationCallback,`callbackData`: Long,
    ): Unit
    external fun ffi_relay_rust_future_cancel_void(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_free_void(`handle`: Long,
    ): Unit
    external fun ffi_relay_rust_future_complete_void(`handle`: Long,uniffi_out_err: UniffiRustCallStatus, 
    ): Unit

        
}

private fun uniffiCheckContractApiVersion(lib: IntegrityCheckingUniffiLib) {
    // Get the bindings contract version from our ComponentInterface
    val bindings_contract_version = 30
    // Get the scaffolding contract version by calling the into the dylib
    val scaffolding_contract_version = lib.ffi_relay_uniffi_contract_version()
    if (bindings_contract_version != scaffolding_contract_version) {
        throw RuntimeException("UniFFI contract version mismatch: try cleaning and rebuilding your project")
    }
}

/**
 * @suppress
 */
public fun uniffiEnsureInitialized() {
    IntegrityCheckingUniffiLib
    // UniffiLib() initialized as objects are used, but we still need to explicitly
    // reference it so initialization across crates works as expected.
    UniffiLib
}

// Async support

// Public interface members begin here.


// Interface implemented by anything that can contain an object reference.
//
// Such types expose a `destroy()` method that must be called to cleanly
// dispose of the contained objects. Failure to call this method may result
// in memory leaks.
//
// The easiest way to ensure this method is called is to use the `.use`
// helper method to execute a block and destroy the object at the end.
interface Disposable {
    fun destroy()
    companion object {
        fun destroy(vararg args: Any?) {
            for (arg in args) {
                when (arg) {
                    is Disposable -> arg.destroy()
                    is ArrayList<*> -> {
                        for (idx in arg.indices) {
                            val element = arg[idx]
                            if (element is Disposable) {
                                element.destroy()
                            }
                        }
                    }
                    is Map<*, *> -> {
                        for (element in arg.values) {
                            if (element is Disposable) {
                                element.destroy()
                            }
                        }
                    }
                    is Iterable<*> -> {
                        for (element in arg) {
                            if (element is Disposable) {
                                element.destroy()
                            }
                        }
                    }
                }
            }
        }
    }
}

/**
 * @suppress
 */
inline fun <T : Disposable?, R> T.use(block: (T) -> R) =
    try {
        block(this)
    } finally {
        try {
            // N.B. our implementation is on the nullable type `Disposable?`.
            this?.destroy()
        } catch (e: Throwable) {
            // swallow
        }
    }

/** 
 * Placeholder object used to signal that we're constructing an interface with a FFI handle.
 *
 * This is the first argument for interface constructors that input a raw handle. It exists is that
 * so we can avoid signature conflicts when an interface has a regular constructor than inputs a
 * Long.
 *
 * @suppress
 * */
object UniffiWithHandle

/** 
 * Used to instantiate an interface without an actual pointer, for fakes in tests, mostly.
 *
 * @suppress
 * */
object NoHandle
/**
 * The cleaner interface for Object finalization code to run.
 * This is the entry point to any implementation that we're using.
 *
 * The cleaner registers objects and returns cleanables, so now we are
 * defining a `UniffiCleaner` with a `UniffiClenaer.Cleanable` to abstract the
 * different implmentations available at compile time.
 *
 * @suppress
 */
interface UniffiCleaner {
    interface Cleanable {
        fun clean()
    }

    fun register(value: Any, cleanUpTask: Runnable): UniffiCleaner.Cleanable

    companion object
}

// The fallback Jna cleaner, which is available for both Android, and the JVM.
private class UniffiJnaCleaner : UniffiCleaner {
    private val cleaner = com.sun.jna.internal.Cleaner.getCleaner()

    override fun register(value: Any, cleanUpTask: Runnable): UniffiCleaner.Cleanable =
        UniffiJnaCleanable(cleaner.register(value, cleanUpTask))
}

private class UniffiJnaCleanable(
    private val cleanable: com.sun.jna.internal.Cleaner.Cleanable,
) : UniffiCleaner.Cleanable {
    override fun clean() = cleanable.clean()
}


// We decide at uniffi binding generation time whether we were
// using Android or not.
// There are further runtime checks to chose the correct implementation
// of the cleaner.
private fun UniffiCleaner.Companion.create(): UniffiCleaner =
    try {
        // For safety's sake: if the library hasn't been run in android_cleaner = true
        // mode, but is being run on Android, then we still need to think about
        // Android API versions.
        // So we check if java.lang.ref.Cleaner is there, and use that…
        java.lang.Class.forName("java.lang.ref.Cleaner")
        JavaLangRefCleaner()
    } catch (e: ClassNotFoundException) {
        // … otherwise, fallback to the JNA cleaner.
        UniffiJnaCleaner()
    }

private class JavaLangRefCleaner : UniffiCleaner {
    val cleaner = java.lang.ref.Cleaner.create()

    override fun register(value: Any, cleanUpTask: Runnable): UniffiCleaner.Cleanable =
        JavaLangRefCleanable(cleaner.register(value, cleanUpTask))
}

private class JavaLangRefCleanable(
    val cleanable: java.lang.ref.Cleaner.Cleanable
) : UniffiCleaner.Cleanable {
    override fun clean() = cleanable.clean()
}

/**
 * @suppress
 */
public object FfiConverterUShort: FfiConverter<UShort, Short> {
    override fun lift(value: Short): UShort {
        return value.toUShort()
    }

    override fun read(buf: ByteBuffer): UShort {
        return lift(buf.getShort())
    }

    override fun lower(value: UShort): Short {
        return value.toShort()
    }

    override fun allocationSize(value: UShort) = 2UL

    override fun write(value: UShort, buf: ByteBuffer) {
        buf.putShort(value.toShort())
    }
}

/**
 * @suppress
 */
public object FfiConverterLong: FfiConverter<Long, Long> {
    override fun lift(value: Long): Long {
        return value
    }

    override fun read(buf: ByteBuffer): Long {
        return buf.getLong()
    }

    override fun lower(value: Long): Long {
        return value
    }

    override fun allocationSize(value: Long) = 8UL

    override fun write(value: Long, buf: ByteBuffer) {
        buf.putLong(value)
    }
}

/**
 * @suppress
 */
public object FfiConverterBoolean: FfiConverter<Boolean, Byte> {
    override fun lift(value: Byte): Boolean {
        return value.toInt() != 0
    }

    override fun read(buf: ByteBuffer): Boolean {
        return lift(buf.get())
    }

    override fun lower(value: Boolean): Byte {
        return if (value) 1.toByte() else 0.toByte()
    }

    override fun allocationSize(value: Boolean) = 1UL

    override fun write(value: Boolean, buf: ByteBuffer) {
        buf.put(lower(value))
    }
}

/**
 * @suppress
 */
public object FfiConverterString: FfiConverter<String, RustBuffer.ByValue> {
    // Note: we don't inherit from FfiConverterRustBuffer, because we use a
    // special encoding when lowering/lifting.  We can use `RustBuffer.len` to
    // store our length and avoid writing it out to the buffer.
    override fun lift(value: RustBuffer.ByValue): String {
        try {
            val byteArr = ByteArray(value.len.toInt())
            value.asByteBuffer()!!.get(byteArr)
            return byteArr.toString(Charsets.UTF_8)
        } finally {
            RustBuffer.free(value)
        }
    }

    override fun read(buf: ByteBuffer): String {
        val len = buf.getInt()
        val byteArr = ByteArray(len)
        buf.get(byteArr)
        return byteArr.toString(Charsets.UTF_8)
    }

    fun toUtf8(value: String): ByteBuffer {
        // Make sure we don't have invalid UTF-16, check for lone surrogates.
        return Charsets.UTF_8.newEncoder().run {
            onMalformedInput(CodingErrorAction.REPORT)
            encode(CharBuffer.wrap(value))
        }
    }

    override fun lower(value: String): RustBuffer.ByValue {
        val byteBuf = toUtf8(value)
        // Ideally we'd pass these bytes to `ffi_bytebuffer_from_bytes`, but doing so would require us
        // to copy them into a JNA `Memory`. So we might as well directly copy them into a `RustBuffer`.
        val rbuf = RustBuffer.alloc(byteBuf.limit().toULong())
        rbuf.asByteBuffer()!!.put(byteBuf)
        return rbuf
    }

    // We aren't sure exactly how many bytes our string will be once it's UTF-8
    // encoded.  Allocate 3 bytes per UTF-16 code unit which will always be
    // enough.
    override fun allocationSize(value: String): ULong {
        val sizeForLength = 4UL
        val sizeForString = value.length.toULong() * 3UL
        return sizeForLength + sizeForString
    }

    override fun write(value: String, buf: ByteBuffer) {
        val byteBuf = toUtf8(value)
        buf.putInt(byteBuf.limit())
        buf.put(byteBuf)
    }
}


// This template implements a class for working with a Rust struct via a handle
// to the live Rust struct on the other side of the FFI.
//
// There's some subtlety here, because we have to be careful not to operate on a Rust
// struct after it has been dropped, and because we must expose a public API for freeing
// theq Kotlin wrapper object in lieu of reliable finalizers. The core requirements are:
//
//   * Each instance holds an opaque handle to the underlying Rust struct.
//     Method calls need to read this handle from the object's state and pass it in to
//     the Rust FFI.
//
//   * When an instance is no longer needed, its handle should be passed to a
//     special destructor function provided by the Rust FFI, which will drop the
//     underlying Rust struct.
//
//   * Given an instance, calling code is expected to call the special
//     `destroy` method in order to free it after use, either by calling it explicitly
//     or by using a higher-level helper like the `use` method. Failing to do so risks
//     leaking the underlying Rust struct.
//
//   * We can't assume that calling code will do the right thing, and must be prepared
//     to handle Kotlin method calls executing concurrently with or even after a call to
//     `destroy`, and to handle multiple (possibly concurrent!) calls to `destroy`.
//
//   * We must never allow Rust code to operate on the underlying Rust struct after
//     the destructor has been called, and must never call the destructor more than once.
//     Doing so may trigger memory unsafety.
//
//   * To mitigate many of the risks of leaking memory and use-after-free unsafety, a `Cleaner`
//     is implemented to call the destructor when the Kotlin object becomes unreachable.
//     This is done in a background thread. This is not a panacea, and client code should be aware that
//      1. the thread may starve if some there are objects that have poorly performing
//     `drop` methods or do significant work in their `drop` methods.
//      2. the thread is shared across the whole library. This can be tuned by using `android_cleaner = true`,
//         or `android = true` in the [`kotlin` section of the `uniffi.toml` file](https://mozilla.github.io/uniffi-rs/kotlin/configuration.html).
//
// If we try to implement this with mutual exclusion on access to the handle, there is the
// possibility of a race between a method call and a concurrent call to `destroy`:
//
//    * Thread A starts a method call, reads the value of the handle, but is interrupted
//      before it can pass the handle over the FFI to Rust.
//    * Thread B calls `destroy` and frees the underlying Rust struct.
//    * Thread A resumes, passing the already-read handle value to Rust and triggering
//      a use-after-free.
//
// One possible solution would be to use a `ReadWriteLock`, with each method call taking
// a read lock (and thus allowed to run concurrently) and the special `destroy` method
// taking a write lock (and thus blocking on live method calls). However, we aim not to
// generate methods with any hidden blocking semantics, and a `destroy` method that might
// block if called incorrectly seems to meet that bar.
//
// So, we achieve our goals by giving each instance an associated `AtomicLong` counter to track
// the number of in-flight method calls, and an `AtomicBoolean` flag to indicate whether `destroy`
// has been called. These are updated according to the following rules:
//
//    * The initial value of the counter is 1, indicating a live object with no in-flight calls.
//      The initial value for the flag is false.
//
//    * At the start of each method call, we atomically check the counter.
//      If it is 0 then the underlying Rust struct has already been destroyed and the call is aborted.
//      If it is nonzero them we atomically increment it by 1 and proceed with the method call.
//
//    * At the end of each method call, we atomically decrement and check the counter.
//      If it has reached zero then we destroy the underlying Rust struct.
//
//    * When `destroy` is called, we atomically flip the flag from false to true.
//      If the flag was already true we silently fail.
//      Otherwise we atomically decrement and check the counter.
//      If it has reached zero then we destroy the underlying Rust struct.
//
// Astute readers may observe that this all sounds very similar to the way that Rust's `Arc<T>` works,
// and indeed it is, with the addition of a flag to guard against multiple calls to `destroy`.
//
// The overall effect is that the underlying Rust struct is destroyed only when `destroy` has been
// called *and* all in-flight method calls have completed, avoiding violating any of the expectations
// of the underlying Rust code.
//
// This makes a cleaner a better alternative to _not_ calling `destroy()` as
// and when the object is finished with, but the abstraction is not perfect: if the Rust object's `drop`
// method is slow, and/or there are many objects to cleanup, and it's on a low end Android device, then the cleaner
// thread may be starved, and the app will leak memory.
//
// In this case, `destroy`ing manually may be a better solution.
//
// The cleaner can live side by side with the manual calling of `destroy`. In the order of responsiveness, uniffi objects
// with Rust peers are reclaimed:
//
// 1. By calling the `destroy` method of the object, which calls `rustObject.free()`. If that doesn't happen:
// 2. When the object becomes unreachable, AND the Cleaner thread gets to call `rustObject.free()`. If the thread is starved then:
// 3. The memory is reclaimed when the process terminates.
//
// [1] https://stackoverflow.com/questions/24376768/can-java-finalize-an-object-when-it-is-still-in-scope/24380219
//


/**
 * Represents a client for the Relay API.
 *
 * Use this struct to connect and authenticate with a Relay server,
 * managing authorization to call protected endpoints.
 *
 * # Authorization
 * - Clients should use the [fxa_client::FirefoxAccount::getAccessToken()] function
 * to obtain a relay-scoped access token (scope: `https://identity.mozilla.com/apps/relay`).
 * - Then, construct the [`RelayClient`] with the access token.
 * All requests will then be authenticated to the Relay server via `Authorization: Bearer {fxa-access-token}`.
 * - The Relay server verifies this token with the FxA OAuth `/verify` endpoint.
 * - Clients are responsible for getting a new access token when needed.
 */
public interface RelayClientInterface {
    
    /**
     * Creates a Relay user record in the Relay service database.
     *
     * This function was originally used to signal acceptance of terms and privacy notices,
     * but now primarily serves to provision (create) the Relay user record if one does not exist.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    fun `acceptTerms`()
    
    /**
     * Creates a new Relay mask (alias) with the specified metadata.
     *
     * This is used to generate a new alias for use in an email field.
     *
     * - `description`: A label shown in the Relay dashboard; defaults to `generated_for`, user-editable later.
     * - `generated_for`: The website for which the address is generated.
     * - `used_on`: Comma-separated list of all websites where this address is used. Only updated by some clients.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    fun `createAddress`(`description`: kotlin.String, `generatedFor`: kotlin.String, `usedOn`: kotlin.String): RelayAddress
    
    /**
     * Retrieves all Relay addresses associated with the current account.
     *
     * Returns a vector of [`RelayAddress`] objects on success.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    fun `fetchAddresses`(): List<RelayAddress>
    
    /**
     * Retrieves the profile for the authenticated user.
     *
     * Returns a [`RelayProfile`] object containing subscription status, usage statistics,
     * and account settings. The `has_premium` field indicates whether the user has
     * an active premium subscription.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response.
     * Provides the HTTP `status` and response `body`; downstream consumers can inspect
     * these fields. If the response body is JSON with `error_code` or `detail` fields,
     * these are parsed and included for more granular handling; otherwise, the raw
     * response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity,
     * with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    fun `fetchProfile`(): RelayProfile
    
    companion object
}

/**
 * Represents a client for the Relay API.
 *
 * Use this struct to connect and authenticate with a Relay server,
 * managing authorization to call protected endpoints.
 *
 * # Authorization
 * - Clients should use the [fxa_client::FirefoxAccount::getAccessToken()] function
 * to obtain a relay-scoped access token (scope: `https://identity.mozilla.com/apps/relay`).
 * - Then, construct the [`RelayClient`] with the access token.
 * All requests will then be authenticated to the Relay server via `Authorization: Bearer {fxa-access-token}`.
 * - The Relay server verifies this token with the FxA OAuth `/verify` endpoint.
 * - Clients are responsible for getting a new access token when needed.
 */
open class RelayClient: Disposable, AutoCloseable, RelayClientInterface
{

    @Suppress("UNUSED_PARAMETER")
    /**
     * @suppress
     */
    constructor(withHandle: UniffiWithHandle, handle: Long) {
        this.handle = handle
        this.cleanable = UniffiLib.CLEANER.register(this, UniffiCleanAction(handle))
    }

    /**
     * @suppress
     *
     * This constructor can be used to instantiate a fake object. Only used for tests. Any
     * attempt to actually use an object constructed this way will fail as there is no
     * connected Rust object.
     */
    @Suppress("UNUSED_PARAMETER")
    constructor(noHandle: NoHandle) {
        this.handle = 0
        this.cleanable = null
    }
    /**
     * Creates a new `RelayClient` instance.
     *
     * The client automatically includes an `X-Relay-Client` header with the platform
     * identifier based on the target OS (e.g., "appservices-ios", "appservices-android",
     * "appservices-macos", etc.) to help the Relay backend distinguish mobile vs desktop requests.
     *
     * # Parameters
     * - `server_url`: Base URL for the Relay API.
     * - `auth_token`: Optional relay-scoped access token (see struct docs).
     *
     * # Returns
     * A new [`RelayClient`] configured for the specified server and token.
     */
    constructor(`serverUrl`: kotlin.String, `authToken`: kotlin.String?) :
        this(UniffiWithHandle, 
    uniffiRustCallWithError(RelayApiException) { _status ->
    UniffiLib.uniffi_relay_fn_constructor_relayclient_new(
    
        FfiConverterString.lower(`serverUrl`),FfiConverterOptionalString.lower(`authToken`),_status)
}
    )

    protected val handle: Long
    protected val cleanable: UniffiCleaner.Cleanable?

    private val wasDestroyed = AtomicBoolean(false)
    private val callCounter = AtomicLong(1)

    override fun destroy() {
        // Only allow a single call to this method.
        // TODO: maybe we should log a warning if called more than once?
        if (this.wasDestroyed.compareAndSet(false, true)) {
            // This decrement always matches the initial count of 1 given at creation time.
            if (this.callCounter.decrementAndGet() == 0L) {
                cleanable?.clean()
            }
        }
    }

    @Synchronized
    override fun close() {
        this.destroy()
    }

    internal inline fun <R> callWithHandle(block: (handle: Long) -> R): R {
        // Check and increment the call counter, to keep the object alive.
        // This needs a compare-and-set retry loop in case of concurrent updates.
        do {
            val c = this.callCounter.get()
            if (c == 0L) {
                throw IllegalStateException("${this.javaClass.simpleName} object has already been destroyed")
            }
            if (c == Long.MAX_VALUE) {
                throw IllegalStateException("${this.javaClass.simpleName} call counter would overflow")
            }
        } while (! this.callCounter.compareAndSet(c, c + 1L))
        // Now we can safely do the method call without the handle being freed concurrently.
        try {
            return block(this.uniffiCloneHandle())
        } finally {
            // This decrement always matches the increment we performed above.
            if (this.callCounter.decrementAndGet() == 0L) {
                cleanable?.clean()
            }
        }
    }

    // Use a static inner class instead of a closure so as not to accidentally
    // capture `this` as part of the cleanable's action.
    private class UniffiCleanAction(private val handle: Long) : Runnable {
        override fun run() {
            if (handle == 0.toLong()) {
                // Fake object created with `NoHandle`, don't try to free.
                return;
            }
            uniffiRustCall { status ->
                UniffiLib.uniffi_relay_fn_free_relayclient(handle, status)
            }
        }
    }

    /**
     * @suppress
     */
    fun uniffiCloneHandle(): Long {
        if (handle == 0.toLong()) {
            throw InternalException("uniffiCloneHandle() called on NoHandle object");
        }
        return uniffiRustCall() { status ->
            UniffiLib.uniffi_relay_fn_clone_relayclient(handle, status)
        }
    }

    
    /**
     * Creates a Relay user record in the Relay service database.
     *
     * This function was originally used to signal acceptance of terms and privacy notices,
     * but now primarily serves to provision (create) the Relay user record if one does not exist.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    @Throws(RelayApiException::class)override fun `acceptTerms`()
        = 
    callWithHandle {
    uniffiRustCallWithError(RelayApiException) { _status ->
    UniffiLib.uniffi_relay_fn_method_relayclient_accept_terms(
        it,
        _status)
}
    }
    
    

    
    /**
     * Creates a new Relay mask (alias) with the specified metadata.
     *
     * This is used to generate a new alias for use in an email field.
     *
     * - `description`: A label shown in the Relay dashboard; defaults to `generated_for`, user-editable later.
     * - `generated_for`: The website for which the address is generated.
     * - `used_on`: Comma-separated list of all websites where this address is used. Only updated by some clients.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    @Throws(RelayApiException::class)override fun `createAddress`(`description`: kotlin.String, `generatedFor`: kotlin.String, `usedOn`: kotlin.String): RelayAddress {
            return FfiConverterTypeRelayAddress.lift(
    callWithHandle {
    uniffiRustCallWithError(RelayApiException) { _status ->
    UniffiLib.uniffi_relay_fn_method_relayclient_create_address(
        it,
        FfiConverterString.lower(`description`),FfiConverterString.lower(`generatedFor`),FfiConverterString.lower(`usedOn`),_status)
}
    }
    )
    }
    

    
    /**
     * Retrieves all Relay addresses associated with the current account.
     *
     * Returns a vector of [`RelayAddress`] objects on success.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response. Provides the HTTP `status` and response `body`; downstream consumers can inspect these fields. If the response body is JSON with `error_code` or `detail` fields, these are parsed and included for more granular handling; otherwise, the raw response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity, with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    @Throws(RelayApiException::class)override fun `fetchAddresses`(): List<RelayAddress> {
            return FfiConverterSequenceTypeRelayAddress.lift(
    callWithHandle {
    uniffiRustCallWithError(RelayApiException) { _status ->
    UniffiLib.uniffi_relay_fn_method_relayclient_fetch_addresses(
        it,
        _status)
}
    }
    )
    }
    

    
    /**
     * Retrieves the profile for the authenticated user.
     *
     * Returns a [`RelayProfile`] object containing subscription status, usage statistics,
     * and account settings. The `has_premium` field indicates whether the user has
     * an active premium subscription.
     *
     * ## Errors
     *
     * - `RelayApi`: Returned for any non-successful (non-2xx) HTTP response.
     * Provides the HTTP `status` and response `body`; downstream consumers can inspect
     * these fields. If the response body is JSON with `error_code` or `detail` fields,
     * these are parsed and included for more granular handling; otherwise, the raw
     * response text is used as the error detail.
     * - `Network`: Returned for transport-level failures, like loss of connectivity,
     * with details in `reason`.
     * - Other variants may be returned for unexpected deserialization, URL, or backend errors.
     */
    @Throws(RelayApiException::class)override fun `fetchProfile`(): RelayProfile {
            return FfiConverterTypeRelayProfile.lift(
    callWithHandle {
    uniffiRustCallWithError(RelayApiException) { _status ->
    UniffiLib.uniffi_relay_fn_method_relayclient_fetch_profile(
        it,
        _status)
}
    }
    )
    }
    

    

    


    
    
    /**
     * @suppress
     */
    companion object
    
}


/**
 * @suppress
 */
public object FfiConverterTypeRelayClient: FfiConverter<RelayClient, Long> {
    override fun lower(value: RelayClient): Long {
        return value.uniffiCloneHandle()
    }

    override fun lift(value: Long): RelayClient {
        return RelayClient(UniffiWithHandle, value)
    }

    override fun read(buf: ByteBuffer): RelayClient {
        return lift(buf.getLong())
    }

    override fun allocationSize(value: RelayClient) = 8UL

    override fun write(value: RelayClient, buf: ByteBuffer) {
        buf.putLong(lower(value))
    }
}


// This template implements a class for working with a Rust struct via a handle
// to the live Rust struct on the other side of the FFI.
//
// There's some subtlety here, because we have to be careful not to operate on a Rust
// struct after it has been dropped, and because we must expose a public API for freeing
// theq Kotlin wrapper object in lieu of reliable finalizers. The core requirements are:
//
//   * Each instance holds an opaque handle to the underlying Rust struct.
//     Method calls need to read this handle from the object's state and pass it in to
//     the Rust FFI.
//
//   * When an instance is no longer needed, its handle should be passed to a
//     special destructor function provided by the Rust FFI, which will drop the
//     underlying Rust struct.
//
//   * Given an instance, calling code is expected to call the special
//     `destroy` method in order to free it after use, either by calling it explicitly
//     or by using a higher-level helper like the `use` method. Failing to do so risks
//     leaking the underlying Rust struct.
//
//   * We can't assume that calling code will do the right thing, and must be prepared
//     to handle Kotlin method calls executing concurrently with or even after a call to
//     `destroy`, and to handle multiple (possibly concurrent!) calls to `destroy`.
//
//   * We must never allow Rust code to operate on the underlying Rust struct after
//     the destructor has been called, and must never call the destructor more than once.
//     Doing so may trigger memory unsafety.
//
//   * To mitigate many of the risks of leaking memory and use-after-free unsafety, a `Cleaner`
//     is implemented to call the destructor when the Kotlin object becomes unreachable.
//     This is done in a background thread. This is not a panacea, and client code should be aware that
//      1. the thread may starve if some there are objects that have poorly performing
//     `drop` methods or do significant work in their `drop` methods.
//      2. the thread is shared across the whole library. This can be tuned by using `android_cleaner = true`,
//         or `android = true` in the [`kotlin` section of the `uniffi.toml` file](https://mozilla.github.io/uniffi-rs/kotlin/configuration.html).
//
// If we try to implement this with mutual exclusion on access to the handle, there is the
// possibility of a race between a method call and a concurrent call to `destroy`:
//
//    * Thread A starts a method call, reads the value of the handle, but is interrupted
//      before it can pass the handle over the FFI to Rust.
//    * Thread B calls `destroy` and frees the underlying Rust struct.
//    * Thread A resumes, passing the already-read handle value to Rust and triggering
//      a use-after-free.
//
// One possible solution would be to use a `ReadWriteLock`, with each method call taking
// a read lock (and thus allowed to run concurrently) and the special `destroy` method
// taking a write lock (and thus blocking on live method calls). However, we aim not to
// generate methods with any hidden blocking semantics, and a `destroy` method that might
// block if called incorrectly seems to meet that bar.
//
// So, we achieve our goals by giving each instance an associated `AtomicLong` counter to track
// the number of in-flight method calls, and an `AtomicBoolean` flag to indicate whether `destroy`
// has been called. These are updated according to the following rules:
//
//    * The initial value of the counter is 1, indicating a live object with no in-flight calls.
//      The initial value for the flag is false.
//
//    * At the start of each method call, we atomically check the counter.
//      If it is 0 then the underlying Rust struct has already been destroyed and the call is aborted.
//      If it is nonzero them we atomically increment it by 1 and proceed with the method call.
//
//    * At the end of each method call, we atomically decrement and check the counter.
//      If it has reached zero then we destroy the underlying Rust struct.
//
//    * When `destroy` is called, we atomically flip the flag from false to true.
//      If the flag was already true we silently fail.
//      Otherwise we atomically decrement and check the counter.
//      If it has reached zero then we destroy the underlying Rust struct.
//
// Astute readers may observe that this all sounds very similar to the way that Rust's `Arc<T>` works,
// and indeed it is, with the addition of a flag to guard against multiple calls to `destroy`.
//
// The overall effect is that the underlying Rust struct is destroyed only when `destroy` has been
// called *and* all in-flight method calls have completed, avoiding violating any of the expectations
// of the underlying Rust code.
//
// This makes a cleaner a better alternative to _not_ calling `destroy()` as
// and when the object is finished with, but the abstraction is not perfect: if the Rust object's `drop`
// method is slow, and/or there are many objects to cleanup, and it's on a low end Android device, then the cleaner
// thread may be starved, and the app will leak memory.
//
// In this case, `destroy`ing manually may be a better solution.
//
// The cleaner can live side by side with the manual calling of `destroy`. In the order of responsiveness, uniffi objects
// with Rust peers are reclaimed:
//
// 1. By calling the `destroy` method of the object, which calls `rustObject.free()`. If that doesn't happen:
// 2. When the object becomes unreachable, AND the Cleaner thread gets to call `rustObject.free()`. If the thread is starved then:
// 3. The memory is reclaimed when the process terminates.
//
// [1] https://stackoverflow.com/questions/24376768/can-java-finalize-an-object-when-it-is-still-in-scope/24380219
//


/**
 * Client for fetching Relay data from Remote Settings
 *
 * This struct holds separate Remote Settings clients for the allowlist and denylist
 * collections. It follows the same pattern as SuggestRemoteSettingsClient.
 */
public interface RelayRemoteSettingsClientInterface {
    
    /**
     * Determines whether Firefox Relay should be offered for a given site.
     *
     * This function implements the Relay visibility decision logic based on three factors:
     * 1. Whether the site is on the denylist
     * 2. Whether the user is an existing Relay user
     * 3. Whether the site is on the allowlist
     *
     * # Decision Logic (in order)
     *
     * 1. If the site is on the **denylist**, don't show Relay (regardless of user status)
     * 2. If the site is NOT on the denylist and the user **is** a Relay user, show Relay
     * 3. If the site is NOT on the denylist and the user is **not** a Relay user, check the allowlist:
     * - If the site is on the **allowlist**, show Relay (to promote Relay to new users)
     * - Otherwise, don't show Relay
     *
     * # Fail-Safe Behavior
     *
     * If Remote Settings is unavailable:
     * - If denylist fetch fails: don't show Relay (conservative: avoid showing on potentially blocked sites)
     * - If allowlist fetch fails for non-Relay users: assume empty (conservative: don't promote without data)
     *
     * # Arguments
     * * `host` - The full hostname (e.g., "mail.google.com", "www.example.com")
     * * `domain` - The registrable domain from PSL (e.g., "google.com", "example.co.uk")
     * * `is_relay_user` - Whether the user already has a Relay account
     *
     * # Public Suffix List (PSL)
     *
     * Mobile clients should use PSL to extract the domain:
     * - **Host**: Full hostname like "mail.google.com"
     * - **Domain**: Registrable domain (eTLD+1) like "google.com"
     * - Swift: Use `URL.host` and extract domain via PSL library
     * - Kotlin: Use `URL.host` and extract domain via PSL library
     *
     * # Returns
     * `true` if Relay should be shown for this site, `false` otherwise
     *
     * # Determining if User is a Relay User
     *
     * Mobile clients should check if the user is a Relay user by calling
     * `FirefoxAccount.getAttachedClients()` and checking if Relay is in the
     * list of attached clients.
     *
     * # Example
     * ```kotlin
     * val url = URL("https://mail.google.com/inbox")
     * val host = url.host // "mail.google.com"
     * val domain = PublicSuffixList.getRegistrableDomain(host) // "google.com"
     *
     * val rsClient = RelayRemoteSettingsClient(remoteSettingsService)
     * val attachedClients = fxAccount.getAttachedClients()
     * val isRelayUser = attachedClients.any { it.clientId == RELAY_CLIENT_ID }
     *
     * if (rsClient.shouldShowRelay(host, domain, isRelayUser)) {
     * // Show Relay UI
     * }
     * ```
     */
    fun `shouldShowRelay`(`host`: kotlin.String, `domain`: kotlin.String, `isRelayUser`: kotlin.Boolean): kotlin.Boolean
    
    companion object
}

/**
 * Client for fetching Relay data from Remote Settings
 *
 * This struct holds separate Remote Settings clients for the allowlist and denylist
 * collections. It follows the same pattern as SuggestRemoteSettingsClient.
 */
open class RelayRemoteSettingsClient: Disposable, AutoCloseable, RelayRemoteSettingsClientInterface
{

    @Suppress("UNUSED_PARAMETER")
    /**
     * @suppress
     */
    constructor(withHandle: UniffiWithHandle, handle: Long) {
        this.handle = handle
        this.cleanable = UniffiLib.CLEANER.register(this, UniffiCleanAction(handle))
    }

    /**
     * @suppress
     *
     * This constructor can be used to instantiate a fake object. Only used for tests. Any
     * attempt to actually use an object constructed this way will fail as there is no
     * connected Rust object.
     */
    @Suppress("UNUSED_PARAMETER")
    constructor(noHandle: NoHandle) {
        this.handle = 0
        this.cleanable = null
    }
    /**
     * Creates a new RelayRemoteSettingsClient from a RemoteSettingsService
     */
    constructor(`rsService`: RemoteSettingsService) :
        this(UniffiWithHandle, 
    uniffiRustCall() { _status ->
    UniffiLib.uniffi_relay_fn_constructor_relayremotesettingsclient_new(
    
        FfiConverterTypeRemoteSettingsService.lower(`rsService`),_status)
}
    )

    protected val handle: Long
    protected val cleanable: UniffiCleaner.Cleanable?

    private val wasDestroyed = AtomicBoolean(false)
    private val callCounter = AtomicLong(1)

    override fun destroy() {
        // Only allow a single call to this method.
        // TODO: maybe we should log a warning if called more than once?
        if (this.wasDestroyed.compareAndSet(false, true)) {
            // This decrement always matches the initial count of 1 given at creation time.
            if (this.callCounter.decrementAndGet() == 0L) {
                cleanable?.clean()
            }
        }
    }

    @Synchronized
    override fun close() {
        this.destroy()
    }

    internal inline fun <R> callWithHandle(block: (handle: Long) -> R): R {
        // Check and increment the call counter, to keep the object alive.
        // This needs a compare-and-set retry loop in case of concurrent updates.
        do {
            val c = this.callCounter.get()
            if (c == 0L) {
                throw IllegalStateException("${this.javaClass.simpleName} object has already been destroyed")
            }
            if (c == Long.MAX_VALUE) {
                throw IllegalStateException("${this.javaClass.simpleName} call counter would overflow")
            }
        } while (! this.callCounter.compareAndSet(c, c + 1L))
        // Now we can safely do the method call without the handle being freed concurrently.
        try {
            return block(this.uniffiCloneHandle())
        } finally {
            // This decrement always matches the increment we performed above.
            if (this.callCounter.decrementAndGet() == 0L) {
                cleanable?.clean()
            }
        }
    }

    // Use a static inner class instead of a closure so as not to accidentally
    // capture `this` as part of the cleanable's action.
    private class UniffiCleanAction(private val handle: Long) : Runnable {
        override fun run() {
            if (handle == 0.toLong()) {
                // Fake object created with `NoHandle`, don't try to free.
                return;
            }
            uniffiRustCall { status ->
                UniffiLib.uniffi_relay_fn_free_relayremotesettingsclient(handle, status)
            }
        }
    }

    /**
     * @suppress
     */
    fun uniffiCloneHandle(): Long {
        if (handle == 0.toLong()) {
            throw InternalException("uniffiCloneHandle() called on NoHandle object");
        }
        return uniffiRustCall() { status ->
            UniffiLib.uniffi_relay_fn_clone_relayremotesettingsclient(handle, status)
        }
    }

    
    /**
     * Determines whether Firefox Relay should be offered for a given site.
     *
     * This function implements the Relay visibility decision logic based on three factors:
     * 1. Whether the site is on the denylist
     * 2. Whether the user is an existing Relay user
     * 3. Whether the site is on the allowlist
     *
     * # Decision Logic (in order)
     *
     * 1. If the site is on the **denylist**, don't show Relay (regardless of user status)
     * 2. If the site is NOT on the denylist and the user **is** a Relay user, show Relay
     * 3. If the site is NOT on the denylist and the user is **not** a Relay user, check the allowlist:
     * - If the site is on the **allowlist**, show Relay (to promote Relay to new users)
     * - Otherwise, don't show Relay
     *
     * # Fail-Safe Behavior
     *
     * If Remote Settings is unavailable:
     * - If denylist fetch fails: don't show Relay (conservative: avoid showing on potentially blocked sites)
     * - If allowlist fetch fails for non-Relay users: assume empty (conservative: don't promote without data)
     *
     * # Arguments
     * * `host` - The full hostname (e.g., "mail.google.com", "www.example.com")
     * * `domain` - The registrable domain from PSL (e.g., "google.com", "example.co.uk")
     * * `is_relay_user` - Whether the user already has a Relay account
     *
     * # Public Suffix List (PSL)
     *
     * Mobile clients should use PSL to extract the domain:
     * - **Host**: Full hostname like "mail.google.com"
     * - **Domain**: Registrable domain (eTLD+1) like "google.com"
     * - Swift: Use `URL.host` and extract domain via PSL library
     * - Kotlin: Use `URL.host` and extract domain via PSL library
     *
     * # Returns
     * `true` if Relay should be shown for this site, `false` otherwise
     *
     * # Determining if User is a Relay User
     *
     * Mobile clients should check if the user is a Relay user by calling
     * `FirefoxAccount.getAttachedClients()` and checking if Relay is in the
     * list of attached clients.
     *
     * # Example
     * ```kotlin
     * val url = URL("https://mail.google.com/inbox")
     * val host = url.host // "mail.google.com"
     * val domain = PublicSuffixList.getRegistrableDomain(host) // "google.com"
     *
     * val rsClient = RelayRemoteSettingsClient(remoteSettingsService)
     * val attachedClients = fxAccount.getAttachedClients()
     * val isRelayUser = attachedClients.any { it.clientId == RELAY_CLIENT_ID }
     *
     * if (rsClient.shouldShowRelay(host, domain, isRelayUser)) {
     * // Show Relay UI
     * }
     * ```
     */override fun `shouldShowRelay`(`host`: kotlin.String, `domain`: kotlin.String, `isRelayUser`: kotlin.Boolean): kotlin.Boolean {
            return FfiConverterBoolean.lift(
    callWithHandle {
    uniffiRustCall() { _status ->
    UniffiLib.uniffi_relay_fn_method_relayremotesettingsclient_should_show_relay(
        it,
        FfiConverterString.lower(`host`),FfiConverterString.lower(`domain`),FfiConverterBoolean.lower(`isRelayUser`),_status)
}
    }
    )
    }
    

    

    


    
    
    /**
     * @suppress
     */
    companion object
    
}


/**
 * @suppress
 */
public object FfiConverterTypeRelayRemoteSettingsClient: FfiConverter<RelayRemoteSettingsClient, Long> {
    override fun lower(value: RelayRemoteSettingsClient): Long {
        return value.uniffiCloneHandle()
    }

    override fun lift(value: Long): RelayRemoteSettingsClient {
        return RelayRemoteSettingsClient(UniffiWithHandle, value)
    }

    override fun read(buf: ByteBuffer): RelayRemoteSettingsClient {
        return lift(buf.getLong())
    }

    override fun allocationSize(value: RelayRemoteSettingsClient) = 8UL

    override fun write(value: RelayRemoteSettingsClient, buf: ByteBuffer) {
        buf.putLong(lower(value))
    }
}



/**
 * Represents a bounce status object nested within the profile.
 */
data class BounceStatus (
    var `paused`: kotlin.Boolean
    , 
    var `bounceType`: kotlin.String
    
){
    

    

    
    companion object
}

/**
 * @suppress
 */
public object FfiConverterTypeBounceStatus: FfiConverterRustBuffer<BounceStatus> {
    override fun read(buf: ByteBuffer): BounceStatus {
        return BounceStatus(
            FfiConverterBoolean.read(buf),
            FfiConverterString.read(buf),
        )
    }

    override fun allocationSize(value: BounceStatus) = (
            FfiConverterBoolean.allocationSize(value.`paused`) +
            FfiConverterString.allocationSize(value.`bounceType`)
    )

    override fun write(value: BounceStatus, buf: ByteBuffer) {
            FfiConverterBoolean.write(value.`paused`, buf)
            FfiConverterString.write(value.`bounceType`, buf)
    }
}



/**
 * Represents a Relay email address object returned by the Relay API.
 *
 * Includes metadata and statistics for an alias, such as its status,
 * usage stats, and identifying information.
 *
 * See:
 * https://mozilla.github.io/fx-private-relay/api_docs.html
 */
data class RelayAddress (
    var `maskType`: kotlin.String
    , 
    var `enabled`: kotlin.Boolean
    , 
    var `description`: kotlin.String
    , 
    var `generatedFor`: kotlin.String
    , 
    var `blockListEmails`: kotlin.Boolean
    , 
    var `usedOn`: kotlin.String?
    , 
    var `id`: kotlin.Long
    , 
    var `address`: kotlin.String
    , 
    var `domain`: kotlin.Long
    , 
    var `fullAddress`: kotlin.String
    , 
    var `createdAt`: kotlin.String
    , 
    var `lastModifiedAt`: kotlin.String
    , 
    var `lastUsedAt`: kotlin.String?
    , 
    var `numForwarded`: kotlin.Long
    , 
    var `numBlocked`: kotlin.Long
    , 
    var `numLevelOneTrackersBlocked`: kotlin.Long
    , 
    var `numReplied`: kotlin.Long
    , 
    var `numSpam`: kotlin.Long
    
){
    

    

    
    companion object
}

/**
 * @suppress
 */
public object FfiConverterTypeRelayAddress: FfiConverterRustBuffer<RelayAddress> {
    override fun read(buf: ByteBuffer): RelayAddress {
        return RelayAddress(
            FfiConverterString.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterString.read(buf),
            FfiConverterString.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterString.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterString.read(buf),
            FfiConverterString.read(buf),
            FfiConverterString.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
        )
    }

    override fun allocationSize(value: RelayAddress) = (
            FfiConverterString.allocationSize(value.`maskType`) +
            FfiConverterBoolean.allocationSize(value.`enabled`) +
            FfiConverterString.allocationSize(value.`description`) +
            FfiConverterString.allocationSize(value.`generatedFor`) +
            FfiConverterBoolean.allocationSize(value.`blockListEmails`) +
            FfiConverterOptionalString.allocationSize(value.`usedOn`) +
            FfiConverterLong.allocationSize(value.`id`) +
            FfiConverterString.allocationSize(value.`address`) +
            FfiConverterLong.allocationSize(value.`domain`) +
            FfiConverterString.allocationSize(value.`fullAddress`) +
            FfiConverterString.allocationSize(value.`createdAt`) +
            FfiConverterString.allocationSize(value.`lastModifiedAt`) +
            FfiConverterOptionalString.allocationSize(value.`lastUsedAt`) +
            FfiConverterLong.allocationSize(value.`numForwarded`) +
            FfiConverterLong.allocationSize(value.`numBlocked`) +
            FfiConverterLong.allocationSize(value.`numLevelOneTrackersBlocked`) +
            FfiConverterLong.allocationSize(value.`numReplied`) +
            FfiConverterLong.allocationSize(value.`numSpam`)
    )

    override fun write(value: RelayAddress, buf: ByteBuffer) {
            FfiConverterString.write(value.`maskType`, buf)
            FfiConverterBoolean.write(value.`enabled`, buf)
            FfiConverterString.write(value.`description`, buf)
            FfiConverterString.write(value.`generatedFor`, buf)
            FfiConverterBoolean.write(value.`blockListEmails`, buf)
            FfiConverterOptionalString.write(value.`usedOn`, buf)
            FfiConverterLong.write(value.`id`, buf)
            FfiConverterString.write(value.`address`, buf)
            FfiConverterLong.write(value.`domain`, buf)
            FfiConverterString.write(value.`fullAddress`, buf)
            FfiConverterString.write(value.`createdAt`, buf)
            FfiConverterString.write(value.`lastModifiedAt`, buf)
            FfiConverterOptionalString.write(value.`lastUsedAt`, buf)
            FfiConverterLong.write(value.`numForwarded`, buf)
            FfiConverterLong.write(value.`numBlocked`, buf)
            FfiConverterLong.write(value.`numLevelOneTrackersBlocked`, buf)
            FfiConverterLong.write(value.`numReplied`, buf)
            FfiConverterLong.write(value.`numSpam`, buf)
    }
}



/**
 * Represents a Relay user profile returned by the Relay API.
 *
 * Contains information about the user's subscription status, usage statistics,
 * and account settings.
 *
 * See: https://mozilla.github.io/fx-private-relay/api_docs.html#tag/privaterelay/operation/profiles_retrieve
 */
data class RelayProfile (
    var `id`: kotlin.Long
    , 
    var `serverStorage`: kotlin.Boolean
    , 
    var `storePhoneLog`: kotlin.Boolean
    , 
    var `subdomain`: kotlin.String?
    , 
    var `hasPremium`: kotlin.Boolean
    , 
    var `hasPhone`: kotlin.Boolean
    , 
    var `hasVpn`: kotlin.Boolean
    , 
    var `hasMegabundle`: kotlin.Boolean
    , 
    var `onboardingState`: kotlin.Long
    , 
    var `onboardingFreeState`: kotlin.Long
    , 
    var `datePhoneRegistered`: kotlin.String?
    , 
    var `dateSubscribed`: kotlin.String?
    , 
    var `avatar`: kotlin.String?
    , 
    var `nextEmailTry`: kotlin.String
    , 
    var `bounceStatus`: BounceStatus
    , 
    var `apiToken`: kotlin.String
    , 
    var `emailsBlocked`: kotlin.Long
    , 
    var `emailsForwarded`: kotlin.Long
    , 
    var `emailsReplied`: kotlin.Long
    , 
    var `levelOneTrackersBlocked`: kotlin.Long
    , 
    var `removeLevelOneEmailTrackers`: kotlin.Boolean?
    , 
    var `totalMasks`: kotlin.Long
    , 
    var `atMaskLimit`: kotlin.Boolean
    , 
    var `metricsEnabled`: kotlin.Boolean
    
){
    

    

    
    companion object
}

/**
 * @suppress
 */
public object FfiConverterTypeRelayProfile: FfiConverterRustBuffer<RelayProfile> {
    override fun read(buf: ByteBuffer): RelayProfile {
        return RelayProfile(
            FfiConverterLong.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterOptionalString.read(buf),
            FfiConverterString.read(buf),
            FfiConverterTypeBounceStatus.read(buf),
            FfiConverterString.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterOptionalBoolean.read(buf),
            FfiConverterLong.read(buf),
            FfiConverterBoolean.read(buf),
            FfiConverterBoolean.read(buf),
        )
    }

    override fun allocationSize(value: RelayProfile) = (
            FfiConverterLong.allocationSize(value.`id`) +
            FfiConverterBoolean.allocationSize(value.`serverStorage`) +
            FfiConverterBoolean.allocationSize(value.`storePhoneLog`) +
            FfiConverterOptionalString.allocationSize(value.`subdomain`) +
            FfiConverterBoolean.allocationSize(value.`hasPremium`) +
            FfiConverterBoolean.allocationSize(value.`hasPhone`) +
            FfiConverterBoolean.allocationSize(value.`hasVpn`) +
            FfiConverterBoolean.allocationSize(value.`hasMegabundle`) +
            FfiConverterLong.allocationSize(value.`onboardingState`) +
            FfiConverterLong.allocationSize(value.`onboardingFreeState`) +
            FfiConverterOptionalString.allocationSize(value.`datePhoneRegistered`) +
            FfiConverterOptionalString.allocationSize(value.`dateSubscribed`) +
            FfiConverterOptionalString.allocationSize(value.`avatar`) +
            FfiConverterString.allocationSize(value.`nextEmailTry`) +
            FfiConverterTypeBounceStatus.allocationSize(value.`bounceStatus`) +
            FfiConverterString.allocationSize(value.`apiToken`) +
            FfiConverterLong.allocationSize(value.`emailsBlocked`) +
            FfiConverterLong.allocationSize(value.`emailsForwarded`) +
            FfiConverterLong.allocationSize(value.`emailsReplied`) +
            FfiConverterLong.allocationSize(value.`levelOneTrackersBlocked`) +
            FfiConverterOptionalBoolean.allocationSize(value.`removeLevelOneEmailTrackers`) +
            FfiConverterLong.allocationSize(value.`totalMasks`) +
            FfiConverterBoolean.allocationSize(value.`atMaskLimit`) +
            FfiConverterBoolean.allocationSize(value.`metricsEnabled`)
    )

    override fun write(value: RelayProfile, buf: ByteBuffer) {
            FfiConverterLong.write(value.`id`, buf)
            FfiConverterBoolean.write(value.`serverStorage`, buf)
            FfiConverterBoolean.write(value.`storePhoneLog`, buf)
            FfiConverterOptionalString.write(value.`subdomain`, buf)
            FfiConverterBoolean.write(value.`hasPremium`, buf)
            FfiConverterBoolean.write(value.`hasPhone`, buf)
            FfiConverterBoolean.write(value.`hasVpn`, buf)
            FfiConverterBoolean.write(value.`hasMegabundle`, buf)
            FfiConverterLong.write(value.`onboardingState`, buf)
            FfiConverterLong.write(value.`onboardingFreeState`, buf)
            FfiConverterOptionalString.write(value.`datePhoneRegistered`, buf)
            FfiConverterOptionalString.write(value.`dateSubscribed`, buf)
            FfiConverterOptionalString.write(value.`avatar`, buf)
            FfiConverterString.write(value.`nextEmailTry`, buf)
            FfiConverterTypeBounceStatus.write(value.`bounceStatus`, buf)
            FfiConverterString.write(value.`apiToken`, buf)
            FfiConverterLong.write(value.`emailsBlocked`, buf)
            FfiConverterLong.write(value.`emailsForwarded`, buf)
            FfiConverterLong.write(value.`emailsReplied`, buf)
            FfiConverterLong.write(value.`levelOneTrackersBlocked`, buf)
            FfiConverterOptionalBoolean.write(value.`removeLevelOneEmailTrackers`, buf)
            FfiConverterLong.write(value.`totalMasks`, buf)
            FfiConverterBoolean.write(value.`atMaskLimit`, buf)
            FfiConverterBoolean.write(value.`metricsEnabled`, buf)
    }
}





sealed class RelayApiException: kotlin.Exception() {
    
    class Network(
        
        val `reason`: kotlin.String
        ) : RelayApiException() {
        override val message
            get() = "reason=${ `reason` }"
    }
    
    class Api(
        
        val `status`: kotlin.UShort, 
        
        val `code`: kotlin.String, 
        
        val `detail`: kotlin.String
        ) : RelayApiException() {
        override val message
            get() = "status=${ `status` }, code=${ `code` }, detail=${ `detail` }"
    }
    
    class Other(
        
        val `reason`: kotlin.String
        ) : RelayApiException() {
        override val message
            get() = "reason=${ `reason` }"
    }
    

    


    companion object ErrorHandler : UniffiRustCallStatusErrorHandler<RelayApiException> {
        override fun lift(error_buf: RustBuffer.ByValue): RelayApiException = FfiConverterTypeRelayApiError.lift(error_buf)
    }

    
}

/**
 * @suppress
 */
public object FfiConverterTypeRelayApiError : FfiConverterRustBuffer<RelayApiException> {
    override fun read(buf: ByteBuffer): RelayApiException {
        

        return when(buf.getInt()) {
            1 -> RelayApiException.Network(
                FfiConverterString.read(buf),
                )
            2 -> RelayApiException.Api(
                FfiConverterUShort.read(buf),
                FfiConverterString.read(buf),
                FfiConverterString.read(buf),
                )
            3 -> RelayApiException.Other(
                FfiConverterString.read(buf),
                )
            else -> throw RuntimeException("invalid error enum value, something is very wrong!!")
        }
    }

    override fun allocationSize(value: RelayApiException): ULong {
        return when(value) {
            is RelayApiException.Network -> (
                // Add the size for the Int that specifies the variant plus the size needed for all fields
                4UL
                + FfiConverterString.allocationSize(value.`reason`)
            )
            is RelayApiException.Api -> (
                // Add the size for the Int that specifies the variant plus the size needed for all fields
                4UL
                + FfiConverterUShort.allocationSize(value.`status`)
                + FfiConverterString.allocationSize(value.`code`)
                + FfiConverterString.allocationSize(value.`detail`)
            )
            is RelayApiException.Other -> (
                // Add the size for the Int that specifies the variant plus the size needed for all fields
                4UL
                + FfiConverterString.allocationSize(value.`reason`)
            )
        }
    }

    override fun write(value: RelayApiException, buf: ByteBuffer) {
        when(value) {
            is RelayApiException.Network -> {
                buf.putInt(1)
                FfiConverterString.write(value.`reason`, buf)
                Unit
            }
            is RelayApiException.Api -> {
                buf.putInt(2)
                FfiConverterUShort.write(value.`status`, buf)
                FfiConverterString.write(value.`code`, buf)
                FfiConverterString.write(value.`detail`, buf)
                Unit
            }
            is RelayApiException.Other -> {
                buf.putInt(3)
                FfiConverterString.write(value.`reason`, buf)
                Unit
            }
        }.let { /* this makes the `when` an expression, which ensures it is exhaustive */ }
    }

}




/**
 * @suppress
 */
public object FfiConverterOptionalBoolean: FfiConverterRustBuffer<kotlin.Boolean?> {
    override fun read(buf: ByteBuffer): kotlin.Boolean? {
        if (buf.get().toInt() == 0) {
            return null
        }
        return FfiConverterBoolean.read(buf)
    }

    override fun allocationSize(value: kotlin.Boolean?): ULong {
        if (value == null) {
            return 1UL
        } else {
            return 1UL + FfiConverterBoolean.allocationSize(value)
        }
    }

    override fun write(value: kotlin.Boolean?, buf: ByteBuffer) {
        if (value == null) {
            buf.put(0)
        } else {
            buf.put(1)
            FfiConverterBoolean.write(value, buf)
        }
    }
}




/**
 * @suppress
 */
public object FfiConverterOptionalString: FfiConverterRustBuffer<kotlin.String?> {
    override fun read(buf: ByteBuffer): kotlin.String? {
        if (buf.get().toInt() == 0) {
            return null
        }
        return FfiConverterString.read(buf)
    }

    override fun allocationSize(value: kotlin.String?): ULong {
        if (value == null) {
            return 1UL
        } else {
            return 1UL + FfiConverterString.allocationSize(value)
        }
    }

    override fun write(value: kotlin.String?, buf: ByteBuffer) {
        if (value == null) {
            buf.put(0)
        } else {
            buf.put(1)
            FfiConverterString.write(value, buf)
        }
    }
}




/**
 * @suppress
 */
public object FfiConverterSequenceTypeRelayAddress: FfiConverterRustBuffer<List<RelayAddress>> {
    override fun read(buf: ByteBuffer): List<RelayAddress> {
        val len = buf.getInt()
        return List<RelayAddress>(len) {
            FfiConverterTypeRelayAddress.read(buf)
        }
    }

    override fun allocationSize(value: List<RelayAddress>): ULong {
        val sizeForLength = 4UL
        val sizeForItems = value.map { FfiConverterTypeRelayAddress.allocationSize(it) }.sum()
        return sizeForLength + sizeForItems
    }

    override fun write(value: List<RelayAddress>, buf: ByteBuffer) {
        buf.putInt(value.size)
        value.iterator().forEach {
            FfiConverterTypeRelayAddress.write(it, buf)
        }
    }
}



