routing

type DIDCommService struct {
	// ServiceEndpoint is the URI for the service.
	ServiceEndpoint string

	// RoutingKeys are the keys to use for routing to this endpoint.
	// May be empty for direct delivery.
	RoutingKeys []string

	// Accept lists accepted message content types.
	Accept []string
}

type Decrypter interface {
	// Decrypt decrypts an encrypted message.
	Decrypt(ctx context.Context, encrypted []byte) ([]byte, error)
}

type Encrypter interface {
	// Encrypt encrypts a plaintext message for the given recipient keys.
	Encrypt(ctx context.Context, plaintext []byte, recipientDIDs []string) ([]byte, error)
}

type Forward struct {
	// ID is the unique message identifier.
	ID string `json:"id"`

	// Type is always ForwardMessageType.
	Type string `json:"type"`

	// To contains the DID of the mediator receiving this forward.
	To []string `json:"to,omitempty"`

	// Body contains the forward-specific fields.
	Body ForwardBody `json:"body"`

	// Attachments contains the wrapped message as an attachment.
	Attachments []message.Attachment `json:"attachments,omitempty"`
}

type ForwardBody struct {
	// Next is the DID or DID URL of the next recipient.
	// This is the entity that should receive the wrapped message.
	Next string `json:"next"`
}

type Hop struct {
	// RecipientDID is the DID that should receive the message at this hop.
	// This is used for encryption (Encrypter interface requires DIDs).
	RecipientDID string

	// RoutingKey is the original key ID from the service endpoint.
	// May be a DID URL (e.g., did:example:mediator#key-1) or a DID.
	// The Encrypter uses RecipientDID (extracted from RoutingKey if needed)
	// since the encryption interface operates on DIDs, not key IDs.
	RoutingKey string

	// ServiceEndpoint is the endpoint URL for this hop (if known).
	ServiceEndpoint string
}

type Route struct {
	// Hops is the sequence of hops from first mediator to final recipient.
	// The last hop is always the final recipient.
	Hops []Hop

	// FinalRecipient is the DID of the ultimate message recipient.
	FinalRecipient string
}

type RouteBuilder struct {
	// contains filtered or unexported fields
}

type ServiceResolver interface {
	// ResolveDIDCommService resolves DIDComm service endpoint information.
	ResolveDIDCommService(ctx context.Context, did string) (*DIDCommService, error)
}