FonsecaFramework 2026.5.12.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 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.