storage

type AttachmentMetadata struct {
	ID         string    // Unique identifier (UUID)
	Name       string    // Original filename
	MimeType   string    // MIME type
	Size       int64     // Size in bytes
	StorageKey string    // Storage backend key
	StorageURI string    // Full URI for retrieval
	UploadedAt time.Time // Upload timestamp
}

type Config struct {
	Driver string // "local", "s3", "gcs", "minio"

	// Local filesystem config
	LocalBasePath string // e.g., "/data/artifacts"
	LocalBaseURL  string // e.g., "http://localhost:8080/attachments"

	// S3-compatible config
	S3Endpoint        string // AWS endpoint or MinIO URL
	S3Region          string // AWS region
	S3Bucket          string // Bucket name
	S3AccessKeyID     string
	S3SecretAccessKey string
	S3UsePathStyle    bool   // For MinIO compatibility
	S3PublicURL       string // Base URL for public access (optional)
}

type Driver interface {
	// Upload stores an attachment and returns metadata
	Upload(ctx context.Context, name, mimeType string, content io.Reader) (*AttachmentMetadata, error)

	// Download retrieves an attachment by storage key
	Download(ctx context.Context, storageKey string) (io.ReadCloser, error)

	// GetMetadata retrieves metadata for an attachment
	GetMetadata(ctx context.Context, storageKey string) (*AttachmentMetadata, error)

	// Delete removes an attachment (for cleanup)
	Delete(ctx context.Context, storageKey string) error

	// GetSignedURL generates a time-limited direct access URL (for cloud storage)
	GetSignedURL(ctx context.Context, storageKey string, expiration time.Duration) (string, error)

	// Name returns the driver name (e.g., "local", "s3")
	Name() string

	// Close cleans up resources
	Close() error
}

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

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