feat: Refactor MinIO Package for Multi-Bucket Operations

[abolfazl-alemi-aa]

Summary

Refactored the MinIO package to support multi-bucket operations. This is a breaking change that removes the default bucket concept and makes all bucket operations explicit.

Motivation

The previous single-bucket design required multiple client instances to work with multiple buckets and made cross-bucket operations difficult. This refactoring enables:

• Working with multiple buckets from a single client
• Explicit bucket operations (clearer code)
• Dynamic bucket management (create, delete, list)
• Better support for multi-tenant architectures

Breaking Changes

1. Configuration

• ❌ Removed BucketName from ConnectionConfig
• ❌ Removed AccessBucketCreation from ConnectionConfig

2. API Signatures

All operations now require explicit bucket parameter:

// Before
client.Put(ctx, "file.txt", reader, size)
client.Get(ctx, "file.txt")

// After
client.Put(ctx, "my-bucket", "file.txt", reader, minio.WithSize(size))
client.Get(ctx, "my-bucket", "file.txt")

3. Put Method Now Uses Functional Options

// Before
client.Put(ctx, key, reader, size)

// After
client.Put(ctx, bucket, key, reader,
    minio.WithSize(size),
    minio.WithContentType("text/plain"))

New Features

1. Bucket Management

client.CreateBucket(ctx, "new-bucket")
client.DeleteBucket(ctx, "old-bucket")
exists, _ := client.BucketExists(ctx, "my-bucket")
buckets, _ := client.ListBuckets(ctx)

2. BucketClient Wrapper

Convenience wrapper for repeated operations on the same bucket:

bucket := client.Bucket("user-uploads")
bucket.Put(ctx, "avatar.jpg", file, minio.WithSize(size))
data, _ := bucket.Get(ctx, "profile.jpg")

3. Functional Options

minio.WithSize(int64)
minio.WithContentType(string)
minio.WithMetadata(map[string]string)
minio.WithRegion(string)
minio.WithObjectLocking(bool)

Migration

Before:

config := minio.Config{
    Connection: minio.ConnectionConfig{
        BucketName: "my-bucket",
        AccessBucketCreation: true,
    },
}
client, _ := minio.NewClient(config)
client.Put(ctx, "file.txt", reader, size)

After:

config := minio.Config{
    Connection: minio.ConnectionConfig{
        // No bucket config
    },
}
client, _ := minio.NewClient(config)
client.CreateBucket(ctx, "my-bucket")
client.Put(ctx, "my-bucket", "file.txt", reader, minio.WithSize(size))