go-lns/pkg/dns/resource.go

// SPDX-License-Identifier: EUPL-1.2

package dns

import (
	"bytes"
	"encoding/base32"
	"encoding/binary"
	"encoding/hex"
	"encoding/json"
	"errors"
	"fmt"
	"net/netip"
	"strings"

	core "dappco.re/go/core"
	"dappco.re/go/lns/pkg/covenant"
)

const resourceEncodingVersion = 0

// ResourceRecord is a DNS resource payload item.
type ResourceRecord interface {
	Type() HSType
}

// Resource mirrors the JS DNS resource container used for covenant payloads.
type Resource struct {
	TTL     int
	Records []ResourceRecord
}

// ResourceJSON represents the JSON form of a DNS resource.
type ResourceJSON struct {
	Records []json.RawMessage `json:"records"`
}

// DNSMessage mirrors the reference DNS response shape used by the JS helpers.
//
// The Go port keeps the payload lightweight and wire-agnostic: answer,
// authority, and additional sections carry the concrete record values that the
// reference helpers project, while AA preserves the authoritative-answer flag.
type DNSMessage struct {
	AA         bool
	Answer     []any
	Authority  []any
	Additional []any
}

// DSRecord mirrors the JS DS payload entry.
type DSRecord struct {
	KeyTag     uint16
	Algorithm  uint8
	DigestType uint8
	Digest     []byte
}

// DSRecordJSON represents the JSON form of a DS record.
type DSRecordJSON struct {
	Type       string `json:"type"`
	KeyTag     uint16 `json:"keyTag"`
	Algorithm  uint8  `json:"algorithm"`
	DigestType uint8  `json:"digestType"`
	Digest     string `json:"digest"`
}

// NSRecord mirrors the JS NS payload entry.
type NSRecord struct {
	NS string
}

// NSRecordJSON represents the JSON form of an NS record.
type NSRecordJSON struct {
	Type string `json:"type"`
	NS   string `json:"ns"`
}

// GLUE4Record mirrors the JS IPv4 glue payload entry.
type GLUE4Record struct {
	NS      string
	Address netip.Addr
}

// GLUE4RecordJSON represents the JSON form of a GLUE4 record.
type GLUE4RecordJSON struct {
	Type    string `json:"type"`
	NS      string `json:"ns"`
	Address string `json:"address"`
}

// GLUE6Record mirrors the JS IPv6 glue payload entry.
type GLUE6Record struct {
	NS      string
	Address netip.Addr
}

// GLUE6RecordJSON represents the JSON form of a GLUE6 record.
type GLUE6RecordJSON struct {
	Type    string `json:"type"`
	NS      string `json:"ns"`
	Address string `json:"address"`
}

// SYNTH4Record mirrors the JS synthesized IPv4 payload entry.
type SYNTH4Record struct {
	Address netip.Addr
}

// SYNTH4RecordJSON represents the JSON form of a SYNTH4 record.
type SYNTH4RecordJSON struct {
	Type    string `json:"type"`
	Address string `json:"address"`
}

// SYNTH6Record mirrors the JS synthesized IPv6 payload entry.
type SYNTH6Record struct {
	Address netip.Addr
}

// SYNTH6RecordJSON represents the JSON form of a SYNTH6 record.
type SYNTH6RecordJSON struct {
	Type    string `json:"type"`
	Address string `json:"address"`
}

// TXTRecord mirrors the JS TXT payload entry.
type TXTRecord struct {
	Entries []string
}

// TXTRecordJSON represents the JSON form of a TXT record.
type TXTRecordJSON struct {
	Type    string   `json:"type"`
	Entries []string `json:"txt"`
}

// GetSize returns the encoded size of the resource payload.
func (r *Resource) GetSize() int {
	if r == nil {
		return 0
	}

	size := 1
	for _, record := range r.Records {
		size += 1 + resourceRecordSize(record)
	}

	return size
}

// NewResource constructs a resource with the reference default TTL.
func NewResource() *Resource {
	return &Resource{TTL: DEFAULT_TTL}
}

// GetNewResource is an alias for NewResource.
func GetNewResource() *Resource {
	return NewResource()
}

// Type returns the DNS record type.
func (DSRecord) Type() HSType { return HSTypeDS }

// GetType is an alias for Type.
func (r DSRecord) GetType() HSType { return r.Type() }

// Type returns the DNS record type.
func (NSRecord) Type() HSType { return HSTypeNS }

// GetType is an alias for Type.
func (r NSRecord) GetType() HSType { return r.Type() }

// GetNS is an alias for the NS field accessor.
func (r NSRecord) GetNS() string { return r.NS }

// Type returns the DNS record type.
func (GLUE4Record) Type() HSType { return HSTypeGLUE4 }

// GetType is an alias for Type.
func (r GLUE4Record) GetType() HSType { return r.Type() }

// GetNS is an alias for the NS field accessor.
func (r GLUE4Record) GetNS() string { return r.NS }

// Type returns the DNS record type.
func (GLUE6Record) Type() HSType { return HSTypeGLUE6 }

// GetType is an alias for Type.
func (r GLUE6Record) GetType() HSType { return r.Type() }

// GetNS is an alias for the NS field accessor.
func (r GLUE6Record) GetNS() string { return r.NS }

// Type returns the DNS record type.
func (SYNTH4Record) Type() HSType { return HSTypeSYNTH4 }

// GetType is an alias for Type.
func (r SYNTH4Record) GetType() HSType { return r.Type() }

// GetNS is an alias for NS.
func (r SYNTH4Record) GetNS() string { return r.NS() }

// Type returns the DNS record type.
func (SYNTH6Record) Type() HSType { return HSTypeSYNTH6 }

// GetType is an alias for Type.
func (r SYNTH6Record) GetType() HSType { return r.Type() }

// GetNS is an alias for NS.
func (r SYNTH6Record) GetNS() string { return r.NS() }

// Type returns the DNS record type.
func (TXTRecord) Type() HSType { return HSTypeTXT }

// GetType is an alias for Type.
func (r TXTRecord) GetType() HSType { return r.Type() }

// NS returns the synthesized target host for a SYNTH4 record.
func (r SYNTH4Record) NS() string {
	if !r.Address.Is4() {
		return "._synth."
	}

	addr := r.Address.As4()
	return synthName(addr[:])
}

// NS returns the synthesized target host for a SYNTH6 record.
func (r SYNTH6Record) NS() string {
	if !r.Address.Is6() {
		return "._synth."
	}

	addr := r.Address.As16()
	return synthName(addr[:])
}

func synthName(ip []byte) string {
	enc := base32.HexEncoding.WithPadding(base32.NoPadding)
	return "_" + strings.ToLower(enc.EncodeToString(ip)) + "._synth."
}

// HasType reports whether the resource contains at least one record of type t.
func (r *Resource) HasType(t HSType) bool {
	if r == nil {
		return false
	}

	for _, record := range r.Records {
		if record != nil && record.Type() == t {
			return true
		}
	}

	return false
}

// GetHasType is an alias for HasType.
func (r *Resource) GetHasType(t HSType) bool {
	return r.HasType(t)
}

// HasNS reports whether the resource contains NS-like authority data.
func (r *Resource) HasNS() bool {
	if r == nil {
		return false
	}

	for _, record := range r.Records {
		if record == nil {
			continue
		}

		switch record.Type() {
		case HSTypeNS, HSTypeGLUE4, HSTypeGLUE6, HSTypeSYNTH4, HSTypeSYNTH6:
			return true
		}
	}

	return false
}

// GetHasNS is an alias for HasNS.
func (r *Resource) GetHasNS() bool {
	return r.HasNS()
}

// HasDS reports whether the resource contains DS records.
func (r *Resource) HasDS() bool {
	return r.HasType(HSTypeDS)
}

// GetHasDS is an alias for HasDS.
func (r *Resource) GetHasDS() bool {
	return r.HasDS()
}

// ToNS projects NS-capable resource entries into authority NS records.
//
// The helper mirrors the JS reference behavior:
// - NS, GLUE, and SYNTH entries all contribute NS targets
// - duplicate targets are emitted once, in first-seen order
func (r *Resource) ToNS(_ string) []NSRecord {
	if r == nil {
		return nil
	}

	authority := make([]NSRecord, 0, len(r.Records))
	seen := make(map[string]struct{}, len(r.Records))

	for _, record := range r.Records {
		ns, ok := resourceAuthorityNS(record)
		if !ok {
			continue
		}

		key := strings.ToLower(fqdn(ns.NS))
		if _, ok := seen[key]; ok {
			continue
		}

		seen[key] = struct{}{}
		authority = append(authority, ns)
	}

	return authority
}

// GetToNS is an alias for ToNS.
func (r *Resource) GetToNS(name string) []NSRecord {
	return r.ToNS(name)
}

// ToGlue projects glue-capable entries into address-bearing glue records.
//
// GLUE records are only returned when their host falls under the requested
// name. SYNTH records always project into their synthetic hostnames.
func (r *Resource) ToGlue(name string) []ResourceRecord {
	if r == nil {
		return nil
	}

	additional := make([]ResourceRecord, 0, len(r.Records))

	for _, record := range r.Records {
		switch rr := record.(type) {
		case GLUE4Record:
			if !isSubdomain(name, rr.NS) {
				continue
			}
			additional = append(additional, rr)
		case *GLUE4Record:
			if rr == nil || !isSubdomain(name, rr.NS) {
				continue
			}
			additional = append(additional, *rr)
		case GLUE6Record:
			if !isSubdomain(name, rr.NS) {
				continue
			}
			additional = append(additional, rr)
		case *GLUE6Record:
			if rr == nil || !isSubdomain(name, rr.NS) {
				continue
			}
			additional = append(additional, *rr)
		case SYNTH4Record:
			additional = append(additional, GLUE4Record{NS: rr.NS(), Address: rr.Address})
		case *SYNTH4Record:
			if rr == nil {
				continue
			}
			additional = append(additional, GLUE4Record{NS: rr.NS(), Address: rr.Address})
		case SYNTH6Record:
			additional = append(additional, GLUE6Record{NS: rr.NS(), Address: rr.Address})
		case *SYNTH6Record:
			if rr == nil {
				continue
			}
			additional = append(additional, GLUE6Record{NS: rr.NS(), Address: rr.Address})
		}
	}

	return additional
}

// GetToGlue is an alias for ToGlue.
func (r *Resource) GetToGlue(name string) []ResourceRecord {
	return r.ToGlue(name)
}

// ToDS filters DS records in first-seen order.
func (r *Resource) ToDS(_ string) []DSRecord {
	if r == nil {
		return nil
	}

	answer := make([]DSRecord, 0, len(r.Records))
	for _, record := range r.Records {
		switch rr := record.(type) {
		case DSRecord:
			answer = append(answer, rr)
		case *DSRecord:
			if rr != nil {
				answer = append(answer, *rr)
			}
		}
	}

	return answer
}

// GetToDS is an alias for ToDS.
func (r *Resource) GetToDS(name string) []DSRecord {
	return r.ToDS(name)
}

// ToTXT filters TXT records in first-seen order.
func (r *Resource) ToTXT(_ string) []TXTRecord {
	if r == nil {
		return nil
	}

	answer := make([]TXTRecord, 0, len(r.Records))
	for _, record := range r.Records {
		switch rr := record.(type) {
		case TXTRecord:
			answer = append(answer, rr)
		case *TXTRecord:
			if rr != nil {
				answer = append(answer, *rr)
			}
		}
	}

	return answer
}

// GetToTXT is an alias for ToTXT.
func (r *Resource) GetToTXT(name string) []TXTRecord {
	return r.ToTXT(name)
}

// ToZone projects the resource into zone-order records.
//
// Authority-like records are emitted first in original order, with duplicate NS
// targets collapsed. Glue records for in-zone hosts are appended last.
func (r *Resource) ToZone(name string) []ResourceRecord {
	if r == nil {
		return nil
	}

	zone := make([]ResourceRecord, 0, len(r.Records)*2)
	seenNS := make(map[string]struct{}, len(r.Records))

	for _, record := range r.Records {
		if record == nil {
			continue
		}

		if ns, ok := resourceAuthorityNS(record); ok {
			key := strings.ToLower(fqdn(ns.NS))
			if _, ok := seenNS[key]; ok {
				continue
			}

			seenNS[key] = struct{}{}
			zone = append(zone, ns)
			continue
		}

		switch rr := record.(type) {
		case DSRecord:
			zone = append(zone, rr)
		case *DSRecord:
			if rr != nil {
				zone = append(zone, *rr)
			}
		case TXTRecord:
			zone = append(zone, rr)
		case *TXTRecord:
			if rr != nil {
				zone = append(zone, *rr)
			}
		}
	}

	for _, record := range r.Records {
		switch rr := record.(type) {
		case GLUE4Record:
			if isSubdomain(name, rr.NS) {
				zone = append(zone, rr)
			}
		case *GLUE4Record:
			if rr != nil && isSubdomain(name, rr.NS) {
				zone = append(zone, *rr)
			}
		case GLUE6Record:
			if isSubdomain(name, rr.NS) {
				zone = append(zone, rr)
			}
		case *GLUE6Record:
			if rr != nil && isSubdomain(name, rr.NS) {
				zone = append(zone, *rr)
			}
		case SYNTH4Record:
			if isSubdomain(name, rr.NS()) {
				zone = append(zone, GLUE4Record{NS: rr.NS(), Address: rr.Address})
			}
		case *SYNTH4Record:
			if rr != nil && isSubdomain(name, rr.NS()) {
				zone = append(zone, GLUE4Record{NS: rr.NS(), Address: rr.Address})
			}
		case SYNTH6Record:
			if isSubdomain(name, rr.NS()) {
				zone = append(zone, GLUE6Record{NS: rr.NS(), Address: rr.Address})
			}
		case *SYNTH6Record:
			if rr != nil && isSubdomain(name, rr.NS()) {
				zone = append(zone, GLUE6Record{NS: rr.NS(), Address: rr.Address})
			}
		}
	}

	return zone
}

// GetToZone is an alias for ToZone.
func (r *Resource) GetToZone(name string) []ResourceRecord {
	return r.ToZone(name)
}

// ToReferral builds the referral/negative-answer message shape used by the JS
// reference helpers.
//
// The referral path returns authority NS/DS records plus glue when the
// resource has NS data. Otherwise, or when DS referrals are disallowed for a
// TLD lookup, the helper returns a negative proof with AA set and an NSEC
// record in authority.
func (r *Resource) ToReferral(name string, typ HSType, isTLD bool) DNSMessage {
	msg := DNSMessage{}
	badReferral := isTLD && typ == HSTypeDS

	if r != nil && r.HasNS() && !badReferral {
		for _, record := range r.ToNS(name) {
			msg.Authority = append(msg.Authority, record)
		}

		for _, record := range r.ToDS(name) {
			msg.Authority = append(msg.Authority, record)
		}

		for _, record := range r.ToGlue(name) {
			msg.Additional = append(msg.Additional, record)
		}

		if !r.HasDS() {
			msg.Authority = append(msg.Authority, r.ToNSEC(name))
		}

		return msg
	}

	msg.AA = true
	msg.Authority = append(msg.Authority, r.ToNSEC(name))
	return msg
}

// GetToReferral is an alias for ToReferral.
func (r *Resource) GetToReferral(name string, typ HSType, isTLD bool) DNSMessage {
	return r.ToReferral(name, typ, isTLD)
}

// ToDNS projects the resource into the JS reference DNS response shape.
//
// Subdomain lookups are routed to the appropriate TLD referral. TLD TXT
// lookups answer directly when the resource has no NS records; DS lookups and
// all other cases fall through to the referral/negative-answer logic.
func (r *Resource) ToDNS(name string, typ HSType) DNSMessage {
	name = fqdn(strings.ToLower(name))
	labels := strings.Split(strings.TrimSuffix(name, "."), ".")
	if len(labels) > 1 {
		return r.ToReferral(labels[len(labels)-1], typ, false)
	}

	msg := DNSMessage{}
	switch typ {
	case HSTypeTXT:
		if r == nil || !r.HasNS() {
			msg.AA = true
			for _, record := range r.ToTXT(name) {
				msg.Answer = append(msg.Answer, record)
			}
		}
	case HSTypeDS:
		// DS TLD lookups intentionally fall through to the referral/negative
		// proof path to match the JS reference helper.
	}

	if len(msg.Answer) == 0 && len(msg.Authority) == 0 {
		return r.ToReferral(name, typ, true)
	}

	return msg
}

// GetToDNS is an alias for ToDNS.
func (r *Resource) GetToDNS(name string, typ HSType) DNSMessage {
	return r.ToDNS(name, typ)
}

// ToNSEC constructs the reference NSEC helper output for the resource.
//
// The bitmap selection matches the JS reference helper:
// - NS-capable resources use TYPE_MAP_NS
// - TXT-only resources use TYPE_MAP_TXT
// - everything else falls back to TYPE_MAP_EMPTY
func (r *Resource) ToNSEC(name string) NSECRecord {
	typeMap := TYPE_MAP_EMPTY
	if r != nil {
		if r.HasNS() {
			typeMap = TYPE_MAP_NS
		} else if r.HasType(HSTypeTXT) {
			typeMap = TYPE_MAP_TXT
		}
	}

	return Create(name, NextName(name), typeMap)
}

// GetToNSEC is an alias for ToNSEC.
func (r *Resource) GetToNSEC(name string) NSECRecord {
	return r.ToNSEC(name)
}

// Encode serializes the resource payload in the reference binary format.
func (r *Resource) Encode() ([]byte, error) {
	if r == nil {
		return nil, core.E("dns.Resource.Encode", "resource is required", nil)
	}

	var buf bytes.Buffer
	buf.WriteByte(resourceEncodingVersion)

	for _, record := range r.Records {
		if record == nil {
			return nil, core.E("dns.Resource.Encode", "record is required", nil)
		}

		buf.WriteByte(byte(record.Type()))
		if err := encodeRecord(&buf, record); err != nil {
			return nil, core.E("dns.Resource.Encode", err.Error(), nil)
		}
	}

	if buf.Len() > covenant.MaxResourceSize {
		return nil, core.E("dns.Resource.Encode", "resource exceeds maximum size", nil)
	}

	return buf.Bytes(), nil
}

// GetEncode is an alias for Encode.
func (r *Resource) GetEncode() ([]byte, error) {
	return r.Encode()
}

// Decode populates the resource from the reference binary format.
func (r *Resource) Decode(raw []byte) error {
	if r == nil {
		return core.E("dns.Resource.Decode", "resource is required", nil)
	}

	if len(raw) == 0 {
		return core.E("dns.Resource.Decode", "resource payload is required", nil)
	}

	if len(raw) > covenant.MaxResourceSize {
		return core.E("dns.Resource.Decode", "resource exceeds maximum size", nil)
	}

	if raw[0] != resourceEncodingVersion {
		return core.E("dns.Resource.Decode", fmt.Sprintf("unknown serialization version: %d", raw[0]), nil)
	}

	r.TTL = DEFAULT_TTL
	r.Records = r.Records[:0]

	pos := 1
	for pos < len(raw) {
		t := HSType(raw[pos])
		pos++

		record, next, known, err := decodeRecord(raw, pos, t)
		if err != nil {
			return core.E("dns.Resource.Decode", err.Error(), nil)
		}
		if !known {
			break
		}

		r.Records = append(r.Records, record)
		pos = next
	}

	return nil
}

// GetDecode is an alias for Decode.
func (r *Resource) GetDecode(raw []byte) error {
	return r.Decode(raw)
}

// GetJSON converts the resource into its JSON representation.
func (r *Resource) GetJSON() ResourceJSON {
	if r == nil {
		return ResourceJSON{}
	}

	jsonView := ResourceJSON{
		Records: make([]json.RawMessage, 0, len(r.Records)),
	}

	for _, record := range r.Records {
		if record == nil {
			continue
		}

		raw, err := json.Marshal(resourceRecordJSON(record))
		if err != nil {
			continue
		}

		jsonView.Records = append(jsonView.Records, raw)
	}

	return jsonView
}

// FromJSON populates the resource from its JSON representation.
func (r *Resource) FromJSON(jsonView ResourceJSON) error {
	if r == nil {
		return core.E("dns.Resource.FromJSON", "resource is required", nil)
	}

	r.TTL = DEFAULT_TTL
	r.Records = r.Records[:0]

	for _, raw := range jsonView.Records {
		record, err := resourceRecordFromJSON(raw)
		if err != nil {
			return err
		}

		r.Records = append(r.Records, record)
	}

	return nil
}

// GetSize returns the encoded size of the DS record.
func (r DSRecord) GetSize() int {
	return 5 + len(r.Digest)
}

// GetSize returns the encoded size of the NS record.
func (r NSRecord) GetSize() int {
	return resourceNameSize(r.NS)
}

// GetSize returns the encoded size of the GLUE4 record.
func (r GLUE4Record) GetSize() int {
	return resourceNameSize(r.NS) + 4
}

// GetSize returns the encoded size of the GLUE6 record.
func (r GLUE6Record) GetSize() int {
	return resourceNameSize(r.NS) + 16
}

// GetSize returns the encoded size of the SYNTH4 record.
func (r SYNTH4Record) GetSize() int {
	return 4
}

// GetSize returns the encoded size of the SYNTH6 record.
func (r SYNTH6Record) GetSize() int {
	return 16
}

// GetSize returns the encoded size of the TXT record.
func (r TXTRecord) GetSize() int {
	size := 1
	for _, entry := range r.Entries {
		size += 1 + len(entry)
	}
	return size
}

// DecodeResource decodes a raw DNS resource payload.
func DecodeResource(raw []byte) (*Resource, error) {
	resource := NewResource()
	if err := resource.Decode(raw); err != nil {
		return nil, err
	}

	return resource, nil
}

// GetDecodeResource is an alias for DecodeResource.
func GetDecodeResource(raw []byte) (*Resource, error) {
	return DecodeResource(raw)
}

func resourceRecordJSON(record ResourceRecord) any {
	switch rr := record.(type) {
	case DSRecord:
		return rr.GetJSON()
	case *DSRecord:
		return rr.GetJSON()
	case NSRecord:
		return rr.GetJSON()
	case *NSRecord:
		return rr.GetJSON()
	case GLUE4Record:
		return rr.GetJSON()
	case *GLUE4Record:
		return rr.GetJSON()
	case GLUE6Record:
		return rr.GetJSON()
	case *GLUE6Record:
		return rr.GetJSON()
	case SYNTH4Record:
		return rr.GetJSON()
	case *SYNTH4Record:
		return rr.GetJSON()
	case SYNTH6Record:
		return rr.GetJSON()
	case *SYNTH6Record:
		return rr.GetJSON()
	case TXTRecord:
		return rr.GetJSON()
	case *TXTRecord:
		return rr.GetJSON()
	default:
		return map[string]any{"type": "UNKNOWN"}
	}
}

func resourceAuthorityNS(record ResourceRecord) (NSRecord, bool) {
	switch rr := record.(type) {
	case NSRecord:
		return rr, true
	case *NSRecord:
		if rr != nil {
			return *rr, true
		}
	case GLUE4Record:
		return NSRecord{NS: rr.NS}, true
	case *GLUE4Record:
		if rr != nil {
			return NSRecord{NS: rr.NS}, true
		}
	case GLUE6Record:
		return NSRecord{NS: rr.NS}, true
	case *GLUE6Record:
		if rr != nil {
			return NSRecord{NS: rr.NS}, true
		}
	case SYNTH4Record:
		return NSRecord{NS: rr.NS()}, true
	case *SYNTH4Record:
		if rr != nil {
			return NSRecord{NS: rr.NS()}, true
		}
	case SYNTH6Record:
		return NSRecord{NS: rr.NS()}, true
	case *SYNTH6Record:
		if rr != nil {
			return NSRecord{NS: rr.NS()}, true
		}
	}

	return NSRecord{}, false
}

func isSubdomain(parent, child string) bool {
	parent = strings.ToLower(fqdn(parent))
	child = strings.ToLower(fqdn(child))

	if parent == "." {
		return true
	}

	if child == parent {
		return true
	}

	return strings.HasSuffix(trimFQDN(child), "."+trimFQDN(parent))
}

func resourceRecordSize(record ResourceRecord) int {
	switch rr := record.(type) {
	case DSRecord:
		return rr.GetSize()
	case *DSRecord:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case NSRecord:
		return rr.GetSize()
	case *NSRecord:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case GLUE4Record:
		return rr.GetSize()
	case *GLUE4Record:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case GLUE6Record:
		return rr.GetSize()
	case *GLUE6Record:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case SYNTH4Record:
		return rr.GetSize()
	case *SYNTH4Record:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case SYNTH6Record:
		return rr.GetSize()
	case *SYNTH6Record:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	case TXTRecord:
		return rr.GetSize()
	case *TXTRecord:
		if rr == nil {
			return 0
		}
		return rr.GetSize()
	default:
		return 0
	}
}

func resourceNameSize(name string) int {
	name = fqdn(name)
	if name == "." {
		return 1
	}

	trimmed := trimFQDN(name)
	if trimmed == "" {
		return 1
	}

	size := 1
	for _, label := range strings.Split(trimmed, ".") {
		size += 1 + len(label)
	}
	return size
}

type resourceRecordProbe struct {
	Type string `json:"type"`
}

func resourceRecordFromJSON(raw json.RawMessage) (ResourceRecord, error) {
	var probe resourceRecordProbe
	if err := json.Unmarshal(raw, &probe); err != nil {
		return nil, core.E("dns.Resource.FromJSON", "invalid record encoding", err)
	}

	switch probe.Type {
	case "DS":
		var jsonRecord DSRecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid DS record", err)
		}
		var record DSRecord
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "NS":
		var jsonRecord NSRecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid NS record", err)
		}
		var record NSRecord
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "GLUE4":
		var jsonRecord GLUE4RecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid GLUE4 record", err)
		}
		var record GLUE4Record
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "GLUE6":
		var jsonRecord GLUE6RecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid GLUE6 record", err)
		}
		var record GLUE6Record
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "SYNTH4":
		var jsonRecord SYNTH4RecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid SYNTH4 record", err)
		}
		var record SYNTH4Record
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "SYNTH6":
		var jsonRecord SYNTH6RecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid SYNTH6 record", err)
		}
		var record SYNTH6Record
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	case "TXT":
		var jsonRecord TXTRecordJSON
		if err := json.Unmarshal(raw, &jsonRecord); err != nil {
			return nil, core.E("dns.Resource.FromJSON", "invalid TXT record", err)
		}
		var record TXTRecord
		if err := record.FromJSON(jsonRecord); err != nil {
			return nil, err
		}
		return record, nil
	default:
		return nil, core.E("dns.Resource.FromJSON", "unknown record type", nil)
	}
}

// GetJSON converts the DS record into its JSON representation.
func (r DSRecord) GetJSON() DSRecordJSON {
	return DSRecordJSON{
		Type:       "DS",
		KeyTag:     r.KeyTag,
		Algorithm:  r.Algorithm,
		DigestType: r.DigestType,
		Digest:     fmt.Sprintf("%x", r.Digest),
	}
}

// FromJSON populates the DS record from its JSON representation.
func (r *DSRecord) FromJSON(jsonView DSRecordJSON) error {
	if jsonView.Type != "DS" {
		return core.E("dns.DSRecord.FromJSON", "invalid DS record type", nil)
	}

	raw, err := hex.DecodeString(jsonView.Digest)
	if err != nil {
		return core.E("dns.DSRecord.FromJSON", "invalid digest encoding", err)
	}

	r.KeyTag = jsonView.KeyTag
	r.Algorithm = jsonView.Algorithm
	r.DigestType = jsonView.DigestType
	r.Digest = append(r.Digest[:0], raw...)
	return nil
}

// GetJSON converts the NS record into its JSON representation.
func (r NSRecord) GetJSON() NSRecordJSON {
	return NSRecordJSON{
		Type: "NS",
		NS:   r.NS,
	}
}

// FromJSON populates the NS record from its JSON representation.
func (r *NSRecord) FromJSON(jsonView NSRecordJSON) error {
	if jsonView.Type != "NS" {
		return core.E("dns.NSRecord.FromJSON", "invalid NS record type", nil)
	}

	r.NS = jsonView.NS
	return nil
}

// GetJSON converts the GLUE4 record into its JSON representation.
func (r GLUE4Record) GetJSON() GLUE4RecordJSON {
	return GLUE4RecordJSON{
		Type:    "GLUE4",
		NS:      r.NS,
		Address: r.Address.String(),
	}
}

// FromJSON populates the GLUE4 record from its JSON representation.
func (r *GLUE4Record) FromJSON(jsonView GLUE4RecordJSON) error {
	if jsonView.Type != "GLUE4" {
		return core.E("dns.GLUE4Record.FromJSON", "invalid GLUE4 record type", nil)
	}

	addr, err := netip.ParseAddr(jsonView.Address)
	if err != nil || !addr.Is4() {
		return core.E("dns.GLUE4Record.FromJSON", "invalid IPv4 address", err)
	}

	r.NS = jsonView.NS
	r.Address = addr
	return nil
}

// GetJSON converts the GLUE6 record into its JSON representation.
func (r GLUE6Record) GetJSON() GLUE6RecordJSON {
	return GLUE6RecordJSON{
		Type:    "GLUE6",
		NS:      r.NS,
		Address: r.Address.String(),
	}
}

// FromJSON populates the GLUE6 record from its JSON representation.
func (r *GLUE6Record) FromJSON(jsonView GLUE6RecordJSON) error {
	if jsonView.Type != "GLUE6" {
		return core.E("dns.GLUE6Record.FromJSON", "invalid GLUE6 record type", nil)
	}

	addr, err := netip.ParseAddr(jsonView.Address)
	if err != nil || !addr.Is6() {
		return core.E("dns.GLUE6Record.FromJSON", "invalid IPv6 address", err)
	}

	r.NS = jsonView.NS
	r.Address = addr
	return nil
}

// GetJSON converts the SYNTH4 record into its JSON representation.
func (r SYNTH4Record) GetJSON() SYNTH4RecordJSON {
	return SYNTH4RecordJSON{
		Type:    "SYNTH4",
		Address: r.Address.String(),
	}
}

// FromJSON populates the SYNTH4 record from its JSON representation.
func (r *SYNTH4Record) FromJSON(jsonView SYNTH4RecordJSON) error {
	if jsonView.Type != "SYNTH4" {
		return core.E("dns.SYNTH4Record.FromJSON", "invalid SYNTH4 record type", nil)
	}

	addr, err := netip.ParseAddr(jsonView.Address)
	if err != nil || !addr.Is4() {
		return core.E("dns.SYNTH4Record.FromJSON", "invalid IPv4 address", err)
	}

	r.Address = addr
	return nil
}

// GetJSON converts the SYNTH6 record into its JSON representation.
func (r SYNTH6Record) GetJSON() SYNTH6RecordJSON {
	return SYNTH6RecordJSON{
		Type:    "SYNTH6",
		Address: r.Address.String(),
	}
}

// FromJSON populates the SYNTH6 record from its JSON representation.
func (r *SYNTH6Record) FromJSON(jsonView SYNTH6RecordJSON) error {
	if jsonView.Type != "SYNTH6" {
		return core.E("dns.SYNTH6Record.FromJSON", "invalid SYNTH6 record type", nil)
	}

	addr, err := netip.ParseAddr(jsonView.Address)
	if err != nil || !addr.Is6() {
		return core.E("dns.SYNTH6Record.FromJSON", "invalid IPv6 address", err)
	}

	r.Address = addr
	return nil
}

// GetJSON converts the TXT record into its JSON representation.
func (r TXTRecord) GetJSON() TXTRecordJSON {
	return TXTRecordJSON{
		Type:    "TXT",
		Entries: append([]string(nil), r.Entries...),
	}
}

// FromJSON populates the TXT record from its JSON representation.
func (r *TXTRecord) FromJSON(jsonView TXTRecordJSON) error {
	if jsonView.Type != "TXT" {
		return core.E("dns.TXTRecord.FromJSON", "invalid TXT record type", nil)
	}

	r.Entries = append(r.Entries[:0], jsonView.Entries...)
	return nil
}

func encodeRecord(buf *bytes.Buffer, record ResourceRecord) error {
	switch rr := record.(type) {
	case DSRecord:
		return encodeDSRecord(buf, rr)
	case *DSRecord:
		return encodeDSRecord(buf, *rr)
	case NSRecord:
		return encodeNSRecord(buf, rr)
	case *NSRecord:
		return encodeNSRecord(buf, *rr)
	case GLUE4Record:
		return encodeGLUE4Record(buf, rr)
	case *GLUE4Record:
		return encodeGLUE4Record(buf, *rr)
	case GLUE6Record:
		return encodeGLUE6Record(buf, rr)
	case *GLUE6Record:
		return encodeGLUE6Record(buf, *rr)
	case SYNTH4Record:
		return encodeSYNTH4Record(buf, rr)
	case *SYNTH4Record:
		return encodeSYNTH4Record(buf, *rr)
	case SYNTH6Record:
		return encodeSYNTH6Record(buf, rr)
	case *SYNTH6Record:
		return encodeSYNTH6Record(buf, *rr)
	case TXTRecord:
		return encodeTXTRecord(buf, rr)
	case *TXTRecord:
		return encodeTXTRecord(buf, *rr)
	default:
		return errors.New("unknown record type")
	}
}

func encodeDSRecord(buf *bytes.Buffer, record DSRecord) error {
	if len(record.Digest) > 255 {
		return errors.New("ds digest exceeds maximum size")
	}

	if err := binary.Write(buf, binary.BigEndian, record.KeyTag); err != nil {
		return err
	}

	buf.WriteByte(record.Algorithm)
	buf.WriteByte(record.DigestType)
	buf.WriteByte(byte(len(record.Digest)))
	buf.Write(record.Digest)
	return nil
}

func encodeNSRecord(buf *bytes.Buffer, record NSRecord) error {
	return writeName(buf, record.NS)
}

func encodeGLUE4Record(buf *bytes.Buffer, record GLUE4Record) error {
	if !record.Address.Is4() {
		return errors.New("glue4 address must be ipv4")
	}

	if err := writeName(buf, record.NS); err != nil {
		return err
	}

	addr := record.Address.As4()
	buf.Write(addr[:])
	return nil
}

func encodeGLUE6Record(buf *bytes.Buffer, record GLUE6Record) error {
	if !record.Address.Is6() {
		return errors.New("glue6 address must be ipv6")
	}

	if err := writeName(buf, record.NS); err != nil {
		return err
	}

	addr := record.Address.As16()
	buf.Write(addr[:])
	return nil
}

func encodeSYNTH4Record(buf *bytes.Buffer, record SYNTH4Record) error {
	if !record.Address.Is4() {
		return errors.New("synth4 address must be ipv4")
	}

	addr := record.Address.As4()
	buf.Write(addr[:])
	return nil
}

func encodeSYNTH6Record(buf *bytes.Buffer, record SYNTH6Record) error {
	if !record.Address.Is6() {
		return errors.New("synth6 address must be ipv6")
	}

	addr := record.Address.As16()
	buf.Write(addr[:])
	return nil
}

func encodeTXTRecord(buf *bytes.Buffer, record TXTRecord) error {
	if len(record.Entries) > 255 {
		return errors.New("txt entry count exceeds maximum size")
	}

	buf.WriteByte(byte(len(record.Entries)))

	for _, entry := range record.Entries {
		if len(entry) > 255 {
			return errors.New("txt entry exceeds maximum size")
		}

		buf.WriteByte(byte(len(entry)))
		buf.WriteString(entry)
	}

	return nil
}

func decodeRecord(raw []byte, pos int, t HSType) (ResourceRecord, int, bool, error) {
	switch t {
	case HSTypeDS:
		return decodeDSRecord(raw, pos)
	case HSTypeNS:
		return decodeNSRecord(raw, pos)
	case HSTypeGLUE4:
		return decodeGLUE4Record(raw, pos)
	case HSTypeGLUE6:
		return decodeGLUE6Record(raw, pos)
	case HSTypeSYNTH4:
		return decodeSYNTH4Record(raw, pos)
	case HSTypeSYNTH6:
		return decodeSYNTH6Record(raw, pos)
	case HSTypeTXT:
		return decodeTXTRecord(raw, pos)
	default:
		return nil, pos, false, nil
	}
}

func decodeDSRecord(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	if len(raw)-pos < 5 {
		return nil, pos, true, errors.New("truncated ds record")
	}

	digestLen := int(raw[pos+4])
	if len(raw)-pos < 5+digestLen {
		return nil, pos, true, errors.New("truncated ds digest")
	}

	record := DSRecord{
		KeyTag:     binary.BigEndian.Uint16(raw[pos : pos+2]),
		Algorithm:  raw[pos+2],
		DigestType: raw[pos+3],
		Digest:     append([]byte(nil), raw[pos+5:pos+5+digestLen]...),
	}
	return record, pos + 5 + digestLen, true, nil
}

func decodeNSRecord(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	name, next, err := readName(raw, pos)
	if err != nil {
		return nil, pos, true, err
	}

	return NSRecord{NS: name}, next, true, nil
}

func decodeGLUE4Record(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	name, next, err := readName(raw, pos)
	if err != nil {
		return nil, pos, true, err
	}

	if len(raw)-next < 4 {
		return nil, pos, true, errors.New("truncated glue4 address")
	}

	addr, ok := netip.AddrFromSlice(raw[next : next+4])
	if !ok {
		return nil, pos, true, errors.New("invalid glue4 address")
	}

	return GLUE4Record{NS: name, Address: addr}, next + 4, true, nil
}

func decodeGLUE6Record(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	name, next, err := readName(raw, pos)
	if err != nil {
		return nil, pos, true, err
	}

	if len(raw)-next < 16 {
		return nil, pos, true, errors.New("truncated glue6 address")
	}

	addr, ok := netip.AddrFromSlice(raw[next : next+16])
	if !ok {
		return nil, pos, true, errors.New("invalid glue6 address")
	}

	return GLUE6Record{NS: name, Address: addr}, next + 16, true, nil
}

func decodeSYNTH4Record(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	if len(raw)-pos < 4 {
		return nil, pos, true, errors.New("truncated synth4 address")
	}

	addr, ok := netip.AddrFromSlice(raw[pos : pos+4])
	if !ok {
		return nil, pos, true, errors.New("invalid synth4 address")
	}

	return SYNTH4Record{Address: addr}, pos + 4, true, nil
}

func decodeSYNTH6Record(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	if len(raw)-pos < 16 {
		return nil, pos, true, errors.New("truncated synth6 address")
	}

	addr, ok := netip.AddrFromSlice(raw[pos : pos+16])
	if !ok {
		return nil, pos, true, errors.New("invalid synth6 address")
	}

	return SYNTH6Record{Address: addr}, pos + 16, true, nil
}

func decodeTXTRecord(raw []byte, pos int) (ResourceRecord, int, bool, error) {
	if len(raw)-pos < 1 {
		return nil, pos, true, errors.New("truncated txt record")
	}

	count := int(raw[pos])
	pos++
	record := TXTRecord{Entries: make([]string, 0, count)}

	for i := 0; i < count; i++ {
		if len(raw)-pos < 1 {
			return nil, pos, true, errors.New("truncated txt entry")
		}

		size := int(raw[pos])
		pos++
		if len(raw)-pos < size {
			return nil, pos, true, errors.New("truncated txt value")
		}

		record.Entries = append(record.Entries, string(raw[pos:pos+size]))
		pos += size
	}

	return record, pos, true, nil
}

func writeName(buf *bytes.Buffer, name string) error {
	name = fqdn(name)
	if name == "." {
		buf.WriteByte(0)
		return nil
	}

	trimmed := trimFQDN(name)
	if trimmed == "" {
		buf.WriteByte(0)
		return nil
	}

	labels := strings.Split(trimmed, ".")
	for _, label := range labels {
		if len(label) == 0 || len(label) > covenant.MaxNameSize {
			return fmt.Errorf("invalid dns label %q", label)
		}

		buf.WriteByte(byte(len(label)))
		buf.WriteString(label)
	}

	buf.WriteByte(0)
	return nil
}

func readName(raw []byte, pos int) (string, int, error) {
	labels, next, err := readNameLabels(raw, pos, 0, map[int]struct{}{})
	if err != nil {
		return "", pos, err
	}

	if len(labels) == 0 {
		return ".", next, nil
	}

	return strings.Join(labels, ".") + ".", next, nil
}

func readNameLabels(raw []byte, pos, depth int, seen map[int]struct{}) ([]string, int, error) {
	if depth > 16 {
		return nil, pos, errors.New("dns name pointer depth exceeded")
	}

	if pos >= len(raw) {
		return nil, pos, errors.New("truncated dns name")
	}

	if _, ok := seen[pos]; ok {
		return nil, pos, errors.New("cyclic dns name pointer")
	}
	seen[pos] = struct{}{}

	labels := make([]string, 0, 4)
	origPos := pos

	for {
		if pos >= len(raw) {
			return nil, origPos, errors.New("truncated dns name")
		}

		size := raw[pos]
		pos++

		switch size & 0xc0 {
		case 0xc0:
			if pos >= len(raw) {
				return nil, origPos, errors.New("truncated dns name pointer")
			}

			offset := int(size&0x3f)<<8 | int(raw[pos])
			pos++

			ptrLabels, _, err := readNameLabels(raw, offset, depth+1, seen)
			if err != nil {
				return nil, origPos, err
			}

			labels = append(labels, ptrLabels...)
			return labels, pos, nil
		case 0x00:
			if size == 0 {
				return labels, pos, nil
			}
		default:
			return nil, origPos, errors.New("unsupported dns name label encoding")
		}

		if size > covenant.MaxNameSize {
			return nil, origPos, errors.New("dns label exceeds maximum size")
		}

		if len(raw)-pos < int(size) {
			return nil, origPos, errors.New("truncated dns label")
		}

		labels = append(labels, string(raw[pos:pos+int(size)]))
		pos += int(size)
	}
}