Yaver.ObjectStorage 1.0.0

Yaver.ObjectStorage

A .NET library for managing object storage operations with Cloudflare R2 and image processing capabilities.

Features

• Object Storage Integration

  • Public and private storage support
  • File upload/download operations
  • Directory listing
  • File existence checks
  • File deletion

• Image Processing

  • Automatic image optimization
  • WebP conversion
  • Multiple variant generation
  • Thumbnail creation
  • Image format detection

• Built-in Integrations

  • Cloudflare R2 Storage
  • ASP.NET Core support
  • Dependency Injection
  • Swagger/OpenAPI documentation

Installation

dotnet add package Yaver.ObjectStorage

Configuration

Add storage configuration to your

appsettings.json

:

{
  "PUBLIC_OBJECT_STORAGE": {
    "ACCESS_KEY": "your-access-key",
    "SECRET_KEY": "your-secret-key",
    "BUCKET_NAME": "your-bucket",
    "ENDPOINT": "your-r2-endpoint"
  },
  "PRIVATE_OBJECT_STORAGE": {
    "ACCESS_KEY": "your-access-key",
    "SECRET_KEY": "your-secret-key",
    "BUCKET_NAME": "your-bucket",
    "ENDPOINT": "your-r2-endpoint"
  }
}

Usage

Service Registration

builder.Services.AddObjectStorages(builder.Configuration);

Basic File Operations

public class StorageService
{
    private readonly IS3Client _client;

    public StorageService(IS3ClientFactory factory)
    {
        _client = factory.CreateClient("public"); // or "private"
    }

    public async Task UploadFileAsync(IFormFile file, string key)
    {
        await _client.PutFileAsync(file, key);
    }

    public async Task<Stream> DownloadFileAsync(string fileName)
    {
        return await _client.GetFileStreamAsync(fileName);
    }
}

Image Processing

// Upload with image variants
await _client.PutImageWithVariantsAsync(
    file,
    key: "images/profile",
    variants: new[] {
        new ImageVariant("thumbnail", Width: 150, Height: 150),
        new ImageVariant("medium", Width: 800),
        new ImageVariant("large", Width: 1200)
    }
);

Sample API

The solution includes a sample API project demonstrating:

• File upload endpoints
• Image processing
• Public/Private storage configuration
• Swagger integration

Run the sample:

cd sample/Sample.Api
dotnet run

License

This project is licensed under the MIT License.