provider

type BaseKeeperConfig struct {
	// Domain is the domain to manage.
	Domain string `json:"domain"`

	// Provider is the DNS provider for the domain.
	//
	//   - "cloudflare": Cloudflare.
	Provider string `json:"provider"`

	// Account is the name of the provider account to use.
	Account string `json:"account"`

	// IPv4Source is the name of the source for the domain's IPv4 address.
	// If empty, the domain's IPv4 address is not managed.
	IPv4Source string `json:"ipv4_source"`

	// IPv6Source is the name of the source for the domain's IPv6 address.
	// If empty, the domain's IPv6 address is not managed.
	IPv6Source string `json:"ipv6_source"`
}

type RecordKeeper interface {
	// FeedSourceState feeds the current IP addresses of the source to the record keeper.
	FeedSourceState(msg producer.Message)

	// FetchRecords fetches the state of the domain's managed DNS records.
	FetchRecords(ctx context.Context) error

	// SyncRecords synchronizes the domain's managed DNS records with the source state,
	// creating or updating records as needed.
	//
	// This method MUST NOT be called before [FeedSourceState] and [FetchRecords].
	// The following errors are returned directly when incorrect usage is detected:
	//
	//   - [ErrKeeperFeedFirst]: [FeedSourceState] was not called before.
	//   - [ErrKeeperFetchFirst]: [FetchRecords] was not called before.
	//
	// When the API response indicates a failure, the returned error must wrap
	// [ErrAPIResponseFailure].
	SyncRecords(ctx context.Context) error
}