FonsecaFramework.Azure 2026.4.8.1

FonsecaFramework.Azure

Azure service integration library for .NET applications.

Overview

FonsecaFramework.Azure is a .NET Standard 2.1 library that provides simplified clients for common Azure services including Blob Storage, File Shares, Azure Communication Services (email), Azure AI / OpenAI chat, Azure DevOps work items, and an LLM chatbot helper with conversation history management.

Installation

dotnet add package FonsecaFramework.Azure

Features

Examples

Upload a File to Azure Blob Storage

using FonsecaFramework.Azure.Blob;

var blobClient = new AzureBlobClient("<connection-string>", "my-container");

using var stream = File.OpenRead("report.pdf");
string uri = await blobClient.UploadFileAsync("reports/report.pdf", stream);
Console.WriteLine($"Uploaded to: {uri}");

List and Delete Blobs

var blobClient = new AzureBlobClient("<connection-string>", "my-container");

List<string> files = await blobClient.ListFileNamesAsync();
foreach (var file in files)
    Console.WriteLine(file);

bool deleted = await blobClient.DeleteBlobIfExistsAsync(
    "reports/old-report.pdf",
    Azure.Storage.Blobs.Models.DeleteSnapshotsOption.IncludeSnapshots);

Send an Email with Azure Communication Services

using FonsecaFramework.Azure.CommunicationService;

var emailService = new EmailService("<communication-services-connection-string>");

bool sent = await emailService.SendEmailAsync(
    Sender: "no-reply@yourdomain.com",
    Subject: "Welcome!",
    Content: "<h1>Hello</h1><p>Thanks for signing up.</p>",
    Recipients: new List<string> { "customer@example.com" });

Chat with Azure AI (OpenAI)

using FonsecaFramework.Azure.AI;

var aiClient = new AzureAIClient(
    subscriptionKey: "<api-key>",
    endpoint: "https://your-resource.openai.azure.com/openai/deployments/gpt-4/chat/completions?api-version=2024-02-01",
    client: new HttpClient(),
    logger: loggerFactory.CreateLogger<AzureAIClient>());

string response = await aiClient.GetChatResponse(
    behavior: SystemBehavior.Default,
    userMessage: "Summarize the benefits of cloud computing.");

Console.WriteLine(response);

Provider-Agnostic LLM Chatbot

using FonsecaFramework.Azure;

var chatBot = new LlmChatBot();

string reply = await chatBot.ProcessLLMCall(
    llmProviderCall: async (history) =>
    {
        // Call any LLM provider with the full conversation history
        return await MyLlmService.GetResponseAsync(history);
    },
    userPrompt: "What is dependency injection?");

Console.WriteLine(reply);
chatBot.ClearChatHistory();

Query Azure DevOps Work Items

using FonsecaFramework.Azure.DevOps;

var devOpsClient = new AzureDevOpsClient(
    organization: "myorg",
    project: "myproject",
    personalAccessToken: "<pat>",
    httpClient: new HttpClient(),
    logger: loggerFactory.CreateLogger<AzureDevOpsClient>());

var workItems = await devOpsClient.GetWorkItemsAsync(
    "SELECT [System.Id], [System.Title] FROM WorkItems WHERE [System.State] = 'Active'");

foreach (var item in workItems)
    Console.WriteLine($"{item.Id}: {item.Title}");

Requirements

• .NET Standard 2.1 compatible runtime
• Azure subscription for the services you intend to use

License

Copyright 2025 Steven Fonseca / VLR Creations

Licensed under the Apache License, Version 2.0. You may use this library free of charge, provided you include the required attribution notices. See the LICENSE file for full terms.