// Copyright (c) 2025-2026 Probo Inc . // // Permission to use, copy, modify, and/or distribute this software for any // purpose with or without fee is hereby granted, provided that the above // copyright notice and this permission notice appear in all copies. // // THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH // REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY // AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, // INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM // LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR // OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR // PERFORMANCE OF THIS SOFTWARE. package filemanager import ( "context" "encoding/base64" "fmt" "io" "net/url" "time" "github.com/aws/aws-sdk-go-v2/service/s3" ) type ( Service struct { s3Client *s3.Client } File interface { GetObjectKey() string GetName() string GetBucketName() string GetMimeType() string } ) func NewService(s3Client *s3.Client) *Service { return &Service{ s3Client: s3Client, } } func (s *Service) GetFileBase64( ctx context.Context, file File, ) (base64Data string, mimeType string, err error) { result, err := s.s3Client.GetObject( ctx, &s3.GetObjectInput{ Bucket: new(file.GetBucketName()), Key: new(file.GetObjectKey()), }, ) if err != nil { return "", "", fmt.Errorf("cannot get file from S3: %w", err) } defer func() { _ = result.Body.Close() }() fileData, err := io.ReadAll(result.Body) if err != nil { return "", "", fmt.Errorf("cannot read file data: %w", err) } base64Data = base64.StdEncoding.EncodeToString(fileData) mimeType = file.GetMimeType() return base64Data, mimeType, nil } // GetFileBytes downloads a file from S3 and returns the raw bytes. func (s *Service) GetFileBytes( ctx context.Context, file File, ) ([]byte, error) { result, err := s.s3Client.GetObject( ctx, &s3.GetObjectInput{ Bucket: new(file.GetBucketName()), Key: new(file.GetObjectKey()), }, ) if err != nil { return nil, fmt.Errorf("cannot get file from S3: %w", err) } defer func() { _ = result.Body.Close() }() data, err := io.ReadAll(result.Body) if err != nil { return nil, fmt.Errorf("cannot read file data: %w", err) } return data, nil } func (s *Service) GetFileSize(content io.Reader) (int64, error) { seeker, ok := content.(io.Seeker) if !ok { return 0, fmt.Errorf("cannot determine file size: content is not seekable") } size, err := seeker.Seek(0, io.SeekEnd) if err != nil { return 0, fmt.Errorf("cannot determine file size: %w", err) } _, err = seeker.Seek(0, io.SeekStart) if err != nil { return 0, fmt.Errorf("cannot reset file position: %w", err) } return size, nil } func (s *Service) PutFile( ctx context.Context, file File, content io.Reader, metadata map[string]string, ) (int64, error) { _, err := s.s3Client.PutObject( ctx, &s3.PutObjectInput{ Bucket: new(file.GetBucketName()), Key: new(file.GetObjectKey()), Body: content, ContentType: new(file.GetMimeType()), CacheControl: new("private, max-age=3600"), Metadata: metadata, }, ) if err != nil { return 0, fmt.Errorf("cannot upload file to S3: %w", err) } headOutput, err := s.s3Client.HeadObject( ctx, &s3.HeadObjectInput{ Bucket: new(file.GetBucketName()), Key: new(file.GetObjectKey()), }, ) if err != nil { return 0, fmt.Errorf("cannot get object metadata: %w", err) } return *headOutput.ContentLength, nil } func (s *Service) GenerateFileUrl( ctx context.Context, file File, expiresIn time.Duration, ) (string, error) { presignClient := s3.NewPresignClient(s.s3Client) encodedFilename := url.QueryEscape(file.GetName()) contentDisposition := fmt.Sprintf("attachment; filename=%q; filename*=UTF-8''%s", encodedFilename, encodedFilename) presignedReq, err := presignClient.PresignGetObject( ctx, &s3.GetObjectInput{ Bucket: new(file.GetBucketName()), Key: new(file.GetObjectKey()), ResponseCacheControl: new("max-age=3600, public"), ResponseContentType: new(file.GetMimeType()), ResponseContentDisposition: &contentDisposition, }, func(opts *s3.PresignOptions) { opts.Expires = expiresIn }, ) if err != nil { return "", fmt.Errorf("cannot presign GetObject request: %w", err) } return presignedReq.URL, nil }