TAF.FileManager.SDK 1.2.0

TAF.FileManager.SDK

HTTP-based SDK for TAF FileManager Service. Provides BusContext extension methods for fetching images as streams, designed for Base64 image embedding in PDF reports.

Installation

dotnet add package TAF.FileManager.SDK

Features

• context.GetImageAsync(path) extension method
• context.GetImageAsBase64Async(path) for direct Base64 conversion
• Graceful 404 handling (returns null, no exception)
• Context header propagation (TenantId, AppId, EnvironmentId)
• Follows same pattern as TAF.MetaData.SDK

Setup

1. Register Services (Program.cs)

// Option 1: Using configuration
builder.Services.AddFileManagerClient(builder.Configuration);

// Option 2: Using manual options
builder.Services.AddFileManagerClient(options =>
{
    options.BaseUrl = "https://localhost:44341";
    options.TimeoutSeconds = 30;
});

2. Initialize Extensions (Program.cs)

var app = builder.Build();

// Initialize after building the service provider
app.Services.InitializeFileManagerExtensions();

3. Configuration (appsettings.json)

{
  "FileManagerService": {
    "BaseUrl": "https://localhost:44341",
    "Timeout": 30
  }
}

Usage

Get Image as Stream

// In any service/handler with BusContext
var imageStream = await context.GetImageAsync("/uploads/logo.png");

if (imageStream != null)
{
    using var memoryStream = new MemoryStream();
    await imageStream.CopyToAsync(memoryStream);
    var base64 = Convert.ToBase64String(memoryStream.ToArray());

    // Use in PDF, HTML, etc.
    var imgSrc = $"data:image/png;base64,{base64}";
}

Get Image as Base64 (Convenience Method)

// Direct Base64 conversion
var base64Image = await context.GetImageAsBase64Async("/uploads/logo.png");

if (base64Image != null)
{
    var imgSrc = $"data:image/png;base64,{base64Image}";
}

With Image Type

// Get icon type image
var iconStream = await context.GetImageAsync("/icons/user.png", type: "Icon");

// Get with record ID
var recordImage = await context.GetImageAsync("/images/profile.png", recordId: "12345");

Error Handling

• 404 Not Found: Returns null (graceful handling)
• Network Errors: Throws HttpRequestException
• Timeout: Throws TimeoutException
• Cancelled: Throws OperationCanceledException

try
{
    var imageStream = await context.GetImageAsync("/uploads/logo.png");

    if (imageStream == null)
    {
        // Image not found - use default or skip
        _logger.LogWarning("Image not found: /uploads/logo.png");
    }
}
catch (HttpRequestException ex)
{
    _logger.LogError(ex, "Failed to fetch image from FileManager");
}

API Reference

BusContext Extensions

Parameters

Version History

• 1.0.0: Initial release with GetImageAsync and GetImageAsBase64Async extension methods

License

MIT