Context passed to Decoder.decode / SuspendingDecoder.decode for runtime configuration (allocator hints, max-size guards, version pins, etc.). Contexts are immutable; with returns a new context.

DecodeException

open class DecodeException(val fieldPath: String, val bufferPosition: Int, val expected: String, val actual: String, cause: Throwable? = null) : IllegalStateException

Open base class for decode failures. Protocol layers subclass and attach domain-specific fields (e.g., MqttReasonCode, WebSocketCloseCode).

DecodeKey

interface DecodeKey<T : Any>

Key visible only to DecodeContext. Define as a Kotlin object.

Decoder

interface Decoder<out T>

Reads T synchronously from a pre-bounded ReadBuffer.

EncodeContext

interface EncodeContext : CodecContext

Context passed to Encoder.encode for runtime configuration. Contexts are immutable; with returns a new context.

EncodeException

open class EncodeException(val fieldPath: String, val reason: String, cause: Throwable? = null) : IllegalStateException

Open base class for encode failures. Protocol layers subclass and attach domain-specific fields.

EncodeKey

interface EncodeKey<T : Any>

Key visible only to EncodeContext. Define as a Kotlin object.

Encoder

interface Encoder<in T>

Writes T to a WriteBuffer.

FramedEncoder

object FramedEncoder

Runtime entry point for the @FramedBy slicing-scheme encode emit. The KSP-generated @FramedBy codec calls encode, which:

FrameDetector

interface FrameDetector

Peeks the next frame size from a StreamProcessor without consuming bytes. Streaming loops use this to gate calls to the synchronous Decoder.

OwnedBytesHandle

expect class OwnedBytesHandle

Opaque, platform-typed handle for bytes that need to outlive the wire frame they were decoded from — IPC forwarding, persistence, debug capture, default-decode for payloads whose codec isn't pinned at decode time.

actual class OwnedBytesHandle

JVM + Android actual for OwnedBytesHandle. See common kdoc for design rationale; both jvm and androidTarget source-sets dependsOn jvmCommonMain so this single file serves both.

actual class OwnedBytesHandle

OwnedBytesHandleCodec

object OwnedBytesHandleCodec : Codec<OwnedBytesHandle>

Canonical Codec for OwnedBytesHandle. Implements buffer-v1 Pattern #2: decode allocates a consumer-owned PlatformBuffer via the factory bound to BufferFactoryKey (falling back to ownedBytesFallbackFactory — BufferFactory.Default on every platform), copies the remaining wire bytes into it, and wraps the result in an OwnedBytesHandle. Encode writes the handle's bytes into the target buffer; wireSize is WireSize.Exact of the carried byte count.