api

type Auth interface {
	// New uses the authentication information to create a Handle.
	New(ctx context.Context, ppfmt pp.PP, cacheExpiration time.Duration) (Handle, bool)
}

type CloudflareAuth struct {
	Token     string
	AccountID string
	BaseURL   string
}

type CloudflareCache = struct {
	// contains filtered or unexported fields
}

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

type Handle interface {
	// ListRecords lists all matching DNS records.
	ListRecords(ctx context.Context, ppfmt pp.PP, domain domain.Domain, ipNet ipnet.Type) (map[string]netip.Addr, bool)

	// DeleteRecord deletes one DNS record.
	DeleteRecord(ctx context.Context, ppfmt pp.PP, domain domain.Domain, ipNet ipnet.Type, id string) bool

	// UpdateRecord updates one DNS record.
	UpdateRecord(ctx context.Context, ppfmt pp.PP, domain domain.Domain, ipNet ipnet.Type, id string, ip netip.Addr) bool

	// CreateRecord creates one DNS record.
	CreateRecord(ctx context.Context, ppfmt pp.PP, domain domain.Domain, ipNet ipnet.Type,
		ip netip.Addr, ttl TTL, proxied bool) (string, bool)

	// FlushCache flushes the API cache. Flushing should automatically happen when other operations encounter errors.
	FlushCache()
}

type TTL int