Guler.Editor.Storage.S3 0.2.0-alpha.0

Stylus.Storage.S3

Stylus için Amazon S3 (ve S3-uyumlu — MinIO, Backblaze B2, DigitalOcean Spaces, Wasabi) tabanlı IStylusFileStorage adapter'ı.

Stylus.Core abstraction'ı üstüne inşa edilmiştir. Default LocalDiskFileStorage yerine bulut storage kullanmak için DI'da register edilir.

Hızlı başlangıç

dotnet add package Stylus.Storage.S3

// Program.cs
using Stylus.Core.FileManager;
using Stylus.Storage.S3;

builder.Services.AddStylus(); // Default LocalDiskFileStorage register edilir

// IStylusFileStorage'i S3 ile override et
builder.Services.AddSingleton<IStylusFileStorage>(sp =>
    new S3FileStorage(new S3FileStorageOptions
    {
        BucketName = "my-stylus-uploads",
        Region = "eu-central-1",
        KeyPrefix = "stylus/",
        // Credentials: env / IAM role / explicit
    }));

TenantScopedFileStorage decorator otomatik sarmalanmaz — istersen manuel:

builder.Services.AddSingleton<S3FileStorage>(sp =>
    new S3FileStorage(new S3FileStorageOptions { ... }));
builder.Services.AddScoped<IStylusFileStorage>(sp =>
{
    var inner = sp.GetRequiredService<S3FileStorage>();
    var auth = sp.GetRequiredService<IStylusAuthorizationContext>();
    return new TenantScopedFileStorage(inner, auth);
});

S3-uyumlu provider örnekleri

MinIO (self-hosted)

new S3FileStorageOptions
{
    BucketName = "stylus",
    Region = "us-east-1",        // placeholder, MinIO ignore eder
    ServiceUrl = "http://localhost:9000",
    ForcePathStyle = true,
    AccessKey = "minioadmin",
    SecretKey = "minioadmin",
}

Backblaze B2

new S3FileStorageOptions
{
    BucketName = "my-bucket",
    Region = "us-west-002",
    ServiceUrl = "https://s3.us-west-002.backblazeb2.com",
    ForcePathStyle = true,
    AccessKey = "<keyId>",
    SecretKey = "<applicationKey>",
}

DigitalOcean Spaces

new S3FileStorageOptions
{
    BucketName = "my-space",
    Region = "fra1",
    ServiceUrl = "https://fra1.digitaloceanspaces.com",
    ForcePathStyle = false,
    AccessKey = "<key>",
    SecretKey = "<secret>",
}

Konfig opsiyonları

Mimari

S3'te native "klasör" kavramı yoktur — Stylus klasör semantiği delimiter='/' ile prefix grouping üzerinden simüle edilir:

• List: ListObjectsV2(prefix='folder/', delimiter='/') → CommonPrefixes (klasörler) + S3Objects (dosyalar)
• CreateDirectory: No-op (S3 explicit klasör desteklemez); upload sırasında otomatik
• Move: Native rename yok; CopyObject + DeleteObject
• Delete recursive: Prefix altındaki tüm key'leri DeleteObjects (batch)

Bağımlılıklar

• Stylus.Core (≥ 0.1.0-alpha.0)
• AWSSDK.S3 (≥ 3.7.405)

Lisans

MIT — Stylus open core taahhüdü (decisions/ADR-003).

Faz 3 alpha durumu

Bu paket Faz 3 alpha sürümündedir. Pilot deployment'larda S3-uyumlu provider'lar (özellikle Türkiye'de yaygın self-hosted MinIO) doğrulanacak.