interfaces

type AuditLogger interface {
	// LogRepositoryConnect logs a repository connection event
	LogRepositoryConnect(ctx context.Context, repositoryID string)

	// LogRepositoryConnectSuccess logs a successful repository connection event
	LogRepositoryConnectSuccess(ctx context.Context, repositoryID string)

	// LogRepositoryConnectFailure logs a failed repository connection event
	LogRepositoryConnectFailure(ctx context.Context, repositoryID string, err error)

	// LogRepositoryDisconnect logs a repository disconnection event
	LogRepositoryDisconnect(ctx context.Context, repositoryID string)

	// LogFileList logs a file listing event
	LogFileList(ctx context.Context, repositoryID, pattern string, count int)

	// LogFileListFailure logs a failed file listing event
	LogFileListFailure(ctx context.Context, repositoryID, pattern string, err error)

	// LogFileDownloadStart logs the start of a file download
	LogFileDownloadStart(ctx context.Context, repositoryID, filePath string)

	// LogFileDownloadSuccess logs a successful file download
	LogFileDownloadSuccess(ctx context.Context, repositoryID, filePath string, sizeBytes int64)

	// LogFileDownloadFailure logs a failed file download
	LogFileDownloadFailure(ctx context.Context, repositoryID, filePath string, err error)

	// LogFileExists logs a file existence check
	LogFileExists(ctx context.Context, repositoryID, filePath string, exists bool)

	// LogFileExistsFailure logs a failed file existence check
	LogFileExistsFailure(ctx context.Context, repositoryID, filePath string, err error)

	// LogGetLastModified logs a last modified time check
	LogGetLastModified(ctx context.Context, repositoryID, filePath string, modTime time.Time)

	// LogGetLastModifiedFailure logs a failed last modified time check
	LogGetLastModifiedFailure(ctx context.Context, repositoryID, filePath string, err error)

	// GenerateComplianceReport generates a compliance report for repository operations
	GenerateComplianceReport(ctx context.Context, repositoryID string, startTime, endTime time.Time) (string, error)
}

type Config struct {
	// URL is the URL of the repository
	URL string

	// Type is the type of repository (HTTP, File, etc.)
	Type string

	// Credentials are the credentials for the repository
	Credentials map[string]string

	// Options are additional options for the repository
	Options map[string]interface{}

	// Timeout is the timeout for repository operations
	Timeout time.Duration
}

type Factory interface {
	// CreateRepository creates a repository from a configuration
	CreateRepository(config *Config) (Repository, error)
}

type FileInfo struct {
	// Path is the path of the file
	Path string
	// Size is the size of the file in bytes
	Size int64
	// ModTime is the last modified time of the file
	ModTime time.Time
	// IsDir indicates if the file is a directory
	IsDir bool
}

type Repository interface {
	// Connect establishes a connection to the repository
	Connect(ctx context.Context) error

	// Disconnect closes the connection to the repository
	Disconnect() error

	// ListFiles lists files in the repository matching the pattern
	ListFiles(ctx context.Context, pattern string) ([]FileInfo, error)

	// GetFile retrieves a file from the repository
	GetFile(ctx context.Context, filePath string) (io.ReadCloser, error)

	// FileExists checks if a file exists in the repository
	FileExists(ctx context.Context, filePath string) (bool, error)

	// GetLastModified gets the last modified time of a file in the repository
	GetLastModified(ctx context.Context, filePath string) (time.Time, error)

	// GetURL returns the URL of the repository
	GetURL() string

	// GetType returns the type of the repository
	GetType() string
}