FonsecaFramework 2026.6.18.1

FonsecaFramework

Base classes and utilities for .NET applications.

Overview

FonsecaFramework is a .NET Standard 2.0 library that provides foundational building blocks for .NET applications. It includes MVVM support, repository patterns, cryptography helpers, JSON serialization extensions, file I/O utilities, email services, and thread-safe collections.

Installation

dotnet add package FonsecaFramework

Features

Examples

OperationResult

Wrap the outcome of any operation with a strongly-typed result:

using FonsecaFramework.Core;

OperationResult<string> success = OperationResult<string>.CreateSuccess("All good");
Console.WriteLine(success.Success); // True
Console.WriteLine(success.Result); // "All good"

OperationResult<string> failure = OperationResult<string>.CreateFailure();
Console.WriteLine(failure.Success); // False

FailableAction

Run an action with an automatic fallback on failure:

using FonsecaFramework.Core;

var result = FailableAction<string, string>.Run(
 action: () => "primary result",
 actionWhenFailed: () => "fallback result"
);

Console.WriteLine(result.Status); // True
Console.WriteLine(result.Success); // "primary result"

AES Encryption / Decryption

using FonsecaFramework.Cryptography;

var encryptor = new Encryptior(Guid.Parse("01234567-89ab-cdef-0123-456789abcdef"));

string encrypted = await encryptor.Encrypt("Hello, World!");
string decrypted = await encryptor.Decrypt(encrypted);
Console.WriteLine(decrypted); // "Hello, World!"

JSON Extensions

using FonsecaFramework.Core;

var obj = new { Name = "Fonseca", Version = 1 };
string json = obj.ToJsonString(); // Serialize
var back = json.ToObject<dynamic>(); // Deserialize

JsonFileManager

using FonsecaFramework.IO;

var manager = new JsonFileManager<MyConfig>();
manager.WriteToFile("config.json", new MyConfig { Key = "value" });
MyConfig config = manager.GetFromFile("config.json");

Thread-Safe List

using FonsecaFramework.Collections;

var list = new List<int>();
list.Add(1); // Thread-safe add
list.Remove(1); // Thread-safe remove
list.Clear(); // Thread-safe clear

Repository Pattern

Implement a data repository by extending the base class:

using FonsecaFramework.Infrastructure;

public class CustomerRepository : Repository<Customer>
{
 public CustomerRepository(RepositorySetting<Customer> settings) : base(settings) { }

 public override Task Delete(long EntityID) { /* your logic */ }
 public override Task<Customer> FindById(long EntityID) { /* your logic */ }
 public override Task<List<Customer>> GetAll() { /* your logic */ }
 public override Task<Customer> Insert(Customer entity) { /* your logic */ }
 public override Task<Customer> Update(Customer entity) { /* your logic */ }
}

Requirements

• .NET Standard 2.0 compatible runtime

License

Copyright 2025 Steven Fonseca / VLR Creations

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