auxiliaryfiles

type CRTListDiff struct {
	// ToCreate contains crt-list files that exist in the desired state but not in the current state.
	ToCreate []CRTListFile

	// ToUpdate contains crt-list files that exist in both states but have different content.
	ToUpdate []CRTListFile

	// ToDelete contains crt-list file paths that exist in the current state but not in the desired state.
	// These are file paths (not full CRTListFile structs) since we only need the path to delete.
	ToDelete []string
}

type CRTListFile struct {
	// Path is the absolute file path to the crt-list file.
	// Example: "/etc/haproxy/crt-lists/crt-list.txt"
	Path string

	// Content is the crt-list file contents (one certificate entry per line).
	// Format: <cert-path> [ssl-options] [sni-filter]
	// Example: "/etc/haproxy/ssl/cert.pem [ocsp-update on] example.com"
	Content string
}

type FileDiff struct {
	// ToCreate contains files that exist in the desired state but not in the current state.
	ToCreate []GeneralFile

	// ToUpdate contains files that exist in both states but have different content.
	ToUpdate []GeneralFile

	// ToDelete contains paths of files that exist in the current state but not in the desired state.
	// These are file paths (not full GeneralFile structs) since we only need the path to delete.
	ToDelete []string
}

type FileDiffGeneric[T FileItem] struct {
	// ToCreate contains files that exist in the desired state but not in the current state.
	ToCreate []T

	// ToUpdate contains files that exist in both states but have different content.
	ToUpdate []T

	// ToDelete contains identifiers of files that exist in the current state but not in the desired state.
	ToDelete []string
}

type FileItem interface {
	// GetIdentifier returns the unique identifier for this file (filename or path).
	GetIdentifier() string

	// GetContent returns the file content.
	GetContent() string
}

type FileOperations[T FileItem] interface {
	// GetAll returns all file identifiers (filenames/paths) currently stored.
	GetAll(ctx context.Context) ([]string, error)

	// GetContent retrieves the content for a specific file by identifier.
	GetContent(ctx context.Context, id string) (string, error)

	// Create creates a new file with the given identifier and content.
	// Returns the reload ID if a reload was triggered (empty string if not).
	Create(ctx context.Context, id, content string) (string, error)

	// Update updates an existing file with new content.
	// Returns the reload ID if a reload was triggered (empty string if not).
	Update(ctx context.Context, id, content string) (string, error)

	// Delete removes a file by identifier.
	Delete(ctx context.Context, id string) error
}

type GeneralFile struct {
	// Filename is the file name (used as API 'id'). Files are stored in
	// /usr/local/etc/haproxy/general/ regardless of the filename provided.
	// Example: "400.http"
	Filename string

	// Content is the file contents as a string. This maps to the 'file' field in
	// multipart form uploads to the Dataplane API.
	Content string
}

type MapFile struct {
	// Path is the absolute file path to the map file.
	// Example: "/etc/haproxy/maps/domains.map"
	Path string

	// Content is the map file contents (one key-value pair per line).
	Content string
}

type MapFileDiff struct {
	// ToCreate contains map files that exist in the desired state but not in the current state.
	ToCreate []MapFile

	// ToUpdate contains map files that exist in both states but have different content.
	ToUpdate []MapFile

	// ToDelete contains map file paths that exist in the current state but not in the desired state.
	// These are file paths (not full MapFile structs) since we only need the path to delete.
	ToDelete []string
}

type SSLCaFile struct {
	// Path is the file path or name of the CA file.
	// Example: "ca-bundle.pem" or "/etc/haproxy/ssl/ca/trusted-cas.pem"
	Path string

	// Content is the PEM-encoded CA certificate data.
	// Can contain multiple CA certificates concatenated together.
	Content string
}

type SSLCaFileDiff struct {
	// ToCreate contains CA files that exist in the desired state but not in the current state.
	ToCreate []SSLCaFile

	// ToUpdate contains CA files that exist in both states but have different content.
	ToUpdate []SSLCaFile

	// ToDelete contains CA file names that exist in the current state but not in the desired state.
	ToDelete []string
}

type SSLCertificate struct {
	// Path is the absolute file path to the certificate.
	// Example: "/etc/haproxy/certs/example.com.pem"
	Path string

	// Content is the PEM-encoded certificate and key data.
	Content string

	// Description is an optional human-readable description of the certificate.
	Description string
}

type SSLCertificateDiff struct {
	// ToCreate contains certificates that exist in the desired state but not in the current state.
	ToCreate []SSLCertificate

	// ToUpdate contains certificates that exist in both states but have different content.
	ToUpdate []SSLCertificate

	// ToDelete contains certificate names that exist in the current state but not in the desired state.
	// These are certificate names (not full SSLCertificate structs) since we only need the name to delete.
	ToDelete []string
}

type SSLCrlFile struct {
	// Path is the file path or name of the CRL file.
	// Example: "revoked.crl" or "/etc/haproxy/ssl/crl/revoked.crl"
	Path string

	// Content is the PEM or DER-encoded CRL data.
	Content string
}

type SSLCrlFileDiff struct {
	// ToCreate contains CRL files that exist in the desired state but not in the current state.
	ToCreate []SSLCrlFile

	// ToUpdate contains CRL files that exist in both states but have different content.
	ToUpdate []SSLCrlFile

	// ToDelete contains CRL file names that exist in the current state but not in the desired state.
	ToDelete []string
}