contentblock

package

v0.3.0 Latest Latest Go to latest Published: May 30, 2026 License: MIT Imports: 3 Imported by: 0

Details

This section is empty.

This section is empty.

func DecodeBlock[T any, B ~string](
	data []byte,
	expected B,
	blockType func(T) B,
	normalize func(*T, B),
) (T, error)

DecodeBlock unmarshals one typed content-block payload and enforces its expected type.

func MarshalEnvelopeJSON[T ~string](blockType T, data json.RawMessage) ([]byte, error)

MarshalEnvelopeJSON preserves the canonical JSON payload stored in an envelope.

func ValidatePayload(block any) error

ValidatePayload rejects nil payloads before they reach encoding/json.

type Envelope[T ~string] struct {
	Type T
	Data json.RawMessage
}

Envelope stores one typed content-block payload in canonical JSON form.

func MarshalEnvelope[T ~string](block any) (Envelope[T], error)

MarshalEnvelope encodes one typed block and returns its canonical envelope data.

func UnmarshalEnvelopeJSON[T ~string](
	data []byte,
	validate func(T, []byte) error,
) (Envelope[T], error)

UnmarshalEnvelopeJSON validates one content-block payload and stores its canonical JSON form.