Wrap provider errors with HTTP status code

alioss.go

@@ -16,6 +16,7 @@ package storage
 
 import (
 	"bytes"
+	"errors"
 	"io"
 	"net/url"
 	"os"
@@ -25,6 +26,27 @@ import (
 	"github.com/aliyun/aliyun-oss-go-sdk/oss"
 )
 
+func wrapAliOSSError(err error) error {
+	if err == nil {
+		return nil
+	}
+	var svcErr oss.ServiceError
+	if errors.As(err, &svcErr) {
+		return &ErrorWithStatusCode{
+			Err:        err,
+			StatusCode: svcErr.StatusCode,
+		}
+	}
+	var unexpectedErr oss.UnexpectedStatusCodeError
+	if errors.As(err, &unexpectedErr) {
+		return &ErrorWithStatusCode{
+			Err:        err,
+			StatusCode: unexpectedErr.Got(),
+		}
+	}
+	return err
+}
+
 type aliOSSStorage struct {
 	conf   *AliOSSConfig
 	bucket *oss.Bucket
@@ -50,7 +72,7 @@ func NewAliOSS(conf *AliOSSConfig) (Storage, error) {
 func (s *aliOSSStorage) UploadData(data []byte, storagePath, contentType string) (string, int64, error) {
 	reader := bytes.NewBuffer(data)
 	if err := s.bucket.PutObject(storagePath, reader, oss.ContentType(contentType)); err != nil {
-		return "", 0, err
+		return "", 0, wrapAliOSSError(err)
 	}
 
 	return s.location(storagePath), int64(len(data)), nil
@@ -63,7 +85,7 @@ func (s *aliOSSStorage) UploadFile(filepath, storagePath, contentType string) (s
 	}
 
 	if err = s.bucket.PutObjectFromFile(storagePath, filepath, oss.ContentType(contentType)); err != nil {
-		return "", 0, err
+		return "", 0, wrapAliOSSError(err)
 	}
 
 	return s.location(storagePath), info.Size(), nil
@@ -82,7 +104,7 @@ func (s *aliOSSStorage) ListObjects(prefix string) ([]string, error) {
 	for {
 		lor, err := s.bucket.ListObjects(oss.Prefix(prefix), marker)
 		if err != nil {
-			return nil, err
+			return nil, wrapAliOSSError(err)
 		}
 
 		for _, object := range lor.Objects {
@@ -101,16 +123,20 @@ func (s *aliOSSStorage) ListObjects(prefix string) ([]string, error) {
 func (s *aliOSSStorage) DownloadData(storagePath string) ([]byte, error) {
 	reader, err := s.bucket.GetObject(storagePath)
 	if err != nil {
-		return nil, err
+		return nil, wrapAliOSSError(err)
 	}
 	defer reader.Close()
 
-	return io.ReadAll(reader)
+	data, err := io.ReadAll(reader)
+	if err != nil {
+		return nil, wrapAliOSSError(err)
+	}
+	return data, nil
 }
 
 func (s *aliOSSStorage) DownloadFile(filepath, storagePath string) (int64, error) {
 	if err := s.bucket.GetObjectToFile(storagePath, filepath); err != nil {
-		return 0, err
+		return 0, wrapAliOSSError(err)
 	}
 
 	info, err := os.Stat(filepath)
@@ -122,14 +148,18 @@ func (s *aliOSSStorage) DownloadFile(filepath, storagePath string) (int64, error
 }
 
 func (s *aliOSSStorage) GeneratePresignedUrl(storagePath string, expiration time.Duration) (string, error) {
-	return s.bucket.SignURL(storagePath, oss.HTTPGet, int64(expiration.Seconds()))
+	u, err := s.bucket.SignURL(storagePath, oss.HTTPGet, int64(expiration.Seconds()))
+	if err != nil {
+		return "", wrapAliOSSError(err)
+	}
+	return u, nil
 }
 
 func (s *aliOSSStorage) DeleteObject(storagePath string) error {
-	return s.bucket.DeleteObject(storagePath)
+	return wrapAliOSSError(s.bucket.DeleteObject(storagePath))
 }
 
 func (s *aliOSSStorage) DeleteObjects(storagePaths []string) error {
 	_, err := s.bucket.DeleteObjects(storagePaths)
-	return err
+	return wrapAliOSSError(err)
 }

azure.go

@@ -23,13 +23,28 @@ import (
 	"path"
 	"time"
 
+	"github.com/Azure/azure-sdk-for-go/sdk/azcore"
 	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
 	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob"
 	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob/blob"
 	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob/sas"
 	"github.com/Azure/azure-sdk-for-go/sdk/storage/azblob/service"
 )
 
+func wrapAzureError(err error) error {
+	if err == nil {
+		return nil
+	}
+	var respErr *azcore.ResponseError
+	if errors.As(err, &respErr) {
+		return &ErrorWithStatusCode{
+			Err:        err,
+			StatusCode: respErr.StatusCode,
+		}
+	}
+	return err
+}
+
 const azureBlockSize = 4 * 1024 * 1024
 const azureParallelism = 16
 
@@ -73,7 +88,7 @@ func (s *azureBLOBStorage) UploadData(data []byte, storagePath, contentType stri
 		Concurrency: azureParallelism,
 	})
 	if err != nil {
-		return "", 0, err
+		return "", 0, wrapAzureError(err)
 	}
 	return s.location(storagePath), int64(len(data)), nil
 }
@@ -98,7 +113,7 @@ func (s *azureBLOBStorage) UploadFile(filepath, storagePath, contentType string)
 		Concurrency: azureParallelism,
 	})
 	if err != nil {
-		return "", 0, err
+		return "", 0, wrapAzureError(err)
 	}
 
 	return s.location(storagePath), stat.Size(), nil
@@ -113,7 +128,7 @@ func (s *azureBLOBStorage) ListObjects(prefix string) ([]string, error) {
 	for pager.More() {
 		page, err := pager.NextPage(context.Background())
 		if err != nil {
-			return nil, err
+			return nil, wrapAzureError(err)
 		}
 		for _, item := range page.Segment.BlobItems {
 			if item.Name != nil {
@@ -131,7 +146,7 @@ func (s *azureBLOBStorage) DownloadData(storagePath string) ([]byte, error) {
 
 	props, err := blobClient.GetProperties(ctx, nil)
 	if err != nil {
-		return nil, err
+		return nil, wrapAzureError(err)
 	}
 	if props.ContentLength == nil {
 		return nil, errors.New("azure: missing content length")
@@ -143,7 +158,7 @@ func (s *azureBLOBStorage) DownloadData(storagePath string) ([]byte, error) {
 		Concurrency: azureParallelism,
 	})
 	if err != nil {
-		return nil, err
+		return nil, wrapAzureError(err)
 	}
 	return buf, nil
 }
@@ -160,7 +175,7 @@ func (s *azureBLOBStorage) DownloadFile(filepath, storagePath string) (int64, er
 		Concurrency: azureParallelism,
 	})
 	if err != nil {
-		return 0, err
+		return 0, wrapAzureError(err)
 	}
 
 	stat, err := file.Stat()
@@ -188,7 +203,7 @@ func (s *azureBLOBStorage) GeneratePresignedUrl(storagePath string, expiration t
 		Expiry: to.Ptr(exp.Format(sas.TimeFormat)),
 	}, nil)
 	if err != nil {
-		return "", err
+		return "", wrapAzureError(err)
 	}
 
 	qp, err := sas.BlobSignatureValues{
@@ -214,7 +229,7 @@ func (s *azureBLOBStorage) GeneratePresignedUrl(storagePath string, expiration t
 
 func (s *azureBLOBStorage) DeleteObject(storagePath string) error {
 	_, err := s.client.DeleteBlob(context.Background(), s.conf.ContainerName, storagePath, nil)
-	return err
+	return wrapAzureError(err)
 }
 
 func (s *azureBLOBStorage) DeleteObjects(storagePaths []string) error {

error.go

@@ -0,0 +1,32 @@
+// Copyright 2026 LiveKit, Inc.
+//
+// Licensed under the Apache License, Version 2.0 (the "License");
+// you may not use this file except in compliance with the License.
+// You may obtain a copy of the License at
+//
+//     http://www.apache.org/licenses/LICENSE-2.0
+//
+// Unless required by applicable law or agreed to in writing, software
+// distributed under the License is distributed on an "AS IS" BASIS,
+// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+// See the License for the specific language governing permissions and
+// limitations under the License.
+
+package storage
+
+import "fmt"
+
+var _ error = (*ErrorWithStatusCode)(nil)
+
+type ErrorWithStatusCode struct {
+	Err        error
+	StatusCode int
+}
+
+func (e *ErrorWithStatusCode) Error() string {
+	return fmt.Sprintf("err: %s, status code: %d", e.Err, e.StatusCode)
+}
+
+func (e *ErrorWithStatusCode) Unwrap() error {
+	return e.Err
+}