jsoncodec

type MarshalError struct {
	// Field is the full name of the field being marshaled, if known.
	Field string
	// Detail is a human-readable description of the failure.
	Detail string
	// Cause is the underlying error, if any.
	Cause error
}

type MarshalOptions struct {
	// EmitDefaultValues emits fields with zero values instead of omitting them.
	// When false (the default), fields holding the zero value for their type
	// are omitted from the JSON output.
	EmitDefaultValues bool

	// UseProtoNames uses proto field names as JSON keys instead of camelCase.
	// When false (the default), field names are converted to lowerCamelCase
	// per the protobuf JSON mapping specification.
	UseProtoNames bool

	// UseEnumNumbers emits enum fields as numeric values instead of string names.
	// When false (the default), enum values are represented by their name strings.
	UseEnumNumbers bool

	// Deterministic causes map fields to be serialized with keys in sorted
	// order: bool false before true, integers numerically, strings
	// lexicographically. When false (the default), map iteration order is
	// undefined.
	Deterministic bool

	// Canonical enables fully deterministic JSON output suitable for
	// content-addressable hashing. When true, forces Deterministic,
	// UseProtoNames, and empty Indent.
	Canonical bool

	// AllowPartial allows marshaling a message that has missing required fields.
	// When false (the default), Marshal returns ErrRequiredNotSet if any proto2
	// required field is not set. When true, required field validation is skipped.
	AllowPartial bool

	// Multiline is a convenience flag that enables multiline indented output.
	// When true and Indent is empty, Indent defaults to two spaces ("  ").
	// When Indent is already set, Multiline has no additional effect.
	Multiline bool

	// Indent specifies the indentation string for pretty-printed output.
	// An empty string produces compact single-line JSON.
	Indent string

	// Resolver is an optional resolver used for resolving Any type URLs
	// during marshaling. Any implementation of registry.MessageResolver is
	// accepted, enabling dependency inversion: callers can supply a
	// *registry.TypeRegistry or any custom resolver. When nil,
	// registry.GlobalTypes is used.
	Resolver registry.MessageResolver
}

type UnmarshalError struct {
	// Field is the full name of the field being unmarshaled, if known.
	Field string
	// Detail is a human-readable description of the failure.
	Detail string
	// Cause is the underlying error, if any.
	Cause error
}

type UnmarshalOptions struct {
	// DiscardUnknown silently ignores unknown JSON keys when true.
	// When false, unknown keys cause an error.
	DiscardUnknown bool

	// AllowPartial allows unmarshaling a message that has missing required
	// fields. When false (the default), Unmarshal returns ErrRequiredNotSet
	// if any proto2 required field is not present after decoding. When true,
	// required field validation is skipped.
	AllowPartial bool

	// RecursionLimit sets the maximum nesting depth allowed during unmarshal.
	// A value of 0 means use the default limit of 10,000.
	RecursionLimit int

	// MaxTokenCount sets the maximum number of JSON tokens consumed during a
	// single unmarshal operation. When exceeded, unmarshal aborts with
	// ErrMaxTokenCountExceeded. A value of 0 means use the default limit of
	// 10 million. This prevents infinite-loop-without-recursion attacks.
	MaxTokenCount int

	// Resolver is an optional resolver used for resolving Any type URLs
	// during unmarshaling. Any implementation of registry.MessageResolver is
	// accepted, enabling dependency inversion: callers can supply a
	// *registry.TypeRegistry or any custom resolver. When nil,
	// registry.GlobalTypes is used.
	Resolver registry.MessageResolver
}