Logit.BlobStorage 1.2.0

📦 Logit.BlobStorage

Paquete NuGet reutilizable para la gestión de archivos en Blob Storage, diseñado para microservicios, APIs y aplicaciones .NET modernas.

Este paquete abstrae:

• Carga de archivos a Blob Storage
• Descarga y eliminación de blobs
• Configuración centralizada vía Dependency Injection
• Manejo consistente de errores y validaciones

Sin acoplarse a controllers, DTOs de API ni frameworks web.

🚀 Características principales

• ✅ Compatible con .NET 6 / 7 / 8
• ✅ Pensado para microservicios y workers
• ✅ Configuración mediante IOptions
• ✅ Excepciones personalizadas
• ✅ Extensible y fácil de testear
• ✅ Sin dependencia directa de ASP.NET Core

📥 Instalación

dotnet add package Logit.BlobStorage

⚙️ Configuración

El paquete NO lee appsettings.json directamente.
La configuración es responsabilidad del proyecto host.

builder.Services.AddBlobStorage(options =>
{
    options.ConnectionString =
        builder.Configuration.GetConnectionString("BlobStorage");
    options.ContainerName = "documents";
});

🧩 Dependency Injection

El paquete expone un método de extensión para registro:

public static IServiceCollection AddBlobStorage(
    this IServiceCollection services,
    Action<BlobStorageOptions> configure)

Registra internamente:

• Servicios de Blob Storage
• Opciones de configuración
• Manejo de excepciones

🗂️ Estructura interna del paquete

Logit.BlobStorage
│
├── Exceptions
│   └── BlobStorageException.cs
│
├── Extensions
│   └── BobStorageServiceCollectionExtensions.cs
│
├── Interface
│   └── IBlobStorageService.cs
│
├── Models
│   └── BlobFileResult.cs
│
├── Options
│   └── BlobStorageOptions.cs
│
├── Services
│   └── BlobStorageService.cs
│
├── DependencyInjection.cs
├── LICENSE.txt
└── README.md

💻 Uso de IBlobStorageService

public interface IBlobStorageService
{
    // Carga de archivos
    Task<FileUploadResult> UploadFileAsync(DocumentFile file, string? containerName = null);
    Task<IEnumerable<FileUploadResult>> UploadMultipleFilesAsync(IEnumerable<(Stream FileStream, string FileName)> files, string? containerName = null);

    // Descarga de archivos
    Task<byte[]?> DownloadFileAsync(string fileName, string? containerName = null);
    Task<Stream?> DownloadStreamingAsync(string fileName, string? containerName = null);
    Task<FileDownloadResult> DownloadDocumentAsync(string fileName, string? containerName = null);
    Task<IEnumerable<FileAttachment>> DownloadDocumentAsync(IEnumerable<DocumentFile> documents, string? containerName = null);

    // Gestión de blobs
    Task<bool> DeleteFileAsync(string fileName, string? containerName = null);
    Task<BlobFileInfo> GetFileInfoAsync(string fileName, string? containerName = null);
    Task<IEnumerable<BlobFileInfo>> ListFilesAsync(string containerName, string? prefix = null);    

}

🧠 Responsabilidad de cada capa

• Interface: contratos públicos
• Services: lógica de acceso a Blob Storage
• Options: configuración vía IOptions
• Models: modelos desacoplados de HTTP
• Exceptions: errores controlados
• Extensions / DependencyInjection: integración con el host

📄 Licencia

MIT License © Logit