storage

type Config struct {
	// Type of storage (s3, minio, local)
	Type StorageType

	// S3/MinIO configuration
	Endpoint        string // MinIO endpoint (e.g., "localhost:9000")
	AccessKey       string
	SecretKey       string
	Region          string
	Bucket          string
	UseSSL          bool
	PathPrefix      string // Optional prefix for all keys (e.g., "images/")
	PresignDuration time.Duration

	// Local storage configuration (for testing)
	LocalPath string // Base directory for local storage
}

type ErrDeleteFailed struct {
	URL string
	Err error
}

type ErrDownloadFailed struct {
	URL string
	Err error
}

type ErrImageNotFound struct {
	URL string
}

type ErrUnsupportedStorageType struct {
	Type string
}

type ErrUploadFailed struct {
	URL string
	Err error
}

type ImageMetadata struct {
	// Original filename
	Filename string

	// MIME type (e.g., "image/jpeg", "image/png")
	ContentType string

	// Size in bytes
	Size int64

	// Image dimensions
	Width  int
	Height int

	// Collection and document IDs for organization
	CollectionName string
	DocumentID     string

	// Additional custom metadata
	Custom map[string]string
}

type ImageStorage interface {
	// Upload stores an image and returns its URL
	// The URL format depends on the storage backend:
	// - S3: https://bucket.s3.region.amazonaws.com/path/to/image.jpg
	// - MinIO: http://localhost:9000/bucket/path/to/image.jpg
	Upload(ctx context.Context, image []byte, metadata ImageMetadata) (string, error)

	// Download retrieves an image by its URL
	Download(ctx context.Context, url string) ([]byte, error)

	// Delete removes an image by its URL
	Delete(ctx context.Context, url string) error

	// Exists checks if an image exists at the given URL
	Exists(ctx context.Context, url string) (bool, error)

	// GetURL returns a pre-signed URL for temporary access (if supported)
	// Duration specifies how long the URL should be valid
	// Returns the original URL if pre-signing is not supported
	GetPresignedURL(ctx context.Context, url string, duration time.Duration) (string, error)

	// GetInfo returns metadata about a stored image
	GetInfo(ctx context.Context, url string) (*ImageMetadata, error)
}

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

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

type StorageType string

type ThumbnailConfig struct {
	// Maximum width in pixels (default: 256)
	MaxWidth int

	// Maximum height in pixels (default: 256)
	MaxHeight int

	// JPEG quality (1-100, default: 85)
	Quality int

	// Output format: "jpeg" or "png" (default: "jpeg")
	Format string
}