CreateSolution.Shared.Common 1.0.2

Shared.Common

Cross-cutting primitives and utilities used by all solutions (framework-agnostic).

Includes (suggested folders)

• Enums/
  • StatusTypes, InformationTypes, FilterOperationTypes
• Models/
  • BaseAddress, BaseCommunication, BaseDefinition, BaseDimension, BaseDocument, BaseEntity, BaseModel, BasePrice, BaseUser, CustomResult, ResultInformation, SearchFilter, SearchValue, SoftDeleteModel, SystemInformationModel, AuditLog (TableLog), TokenValidationModel
• Extensions/
  • DateTimeExtensions, EnumExtensions, CultureExtensions (for NumberFormatInfo), ObjectExtensions, StringExtensions, QueryableExtensions
• Attributes/
  • Validation attributes (e.g., RequiredIfAttribute)
• Helpers/
  • ReflectionHelper, XmlHelper
• (optional) Security/
  • JwtClaims helper for reading claims from JWT payloads

Install

dotnet add package Shared.Common

Target Frameworks

• net8.0

Namespace

Shared.Common.* (e.g., Shared.Common.Models.CustomResult, Shared.Common.Extensions.QueryableExtensions)

Example: CustomResult

namespace Shared.Common.Models;

public sealed record ResultInformation(string Code, string Message);

public sealed class CustomResult<T>
{
    public bool Success { get; init; }
    public T? Data { get; init; }
    public ResultInformation? Info { get; init; }

    public static CustomResult<T> Ok(T data, string? message = null)
        => new() { Success = true, Data = data, Info = message is null ? null : new ResultInformation("OK", message) };

    public static CustomResult<T> Fail(string code, string message)
        => new() { Success = false, Info = new ResultInformation(code, message) };
}

Example: QueryableExtensions (minimal)

using System.Linq.Expressions;

namespace Shared.Common.Extensions;

public static class QueryableExtensions
{
    public static IQueryable<T> WhereIf<T>(this IQueryable<T> query, bool condition, Expression<Func<T, bool>> predicate)
        => condition ? query.Where(predicate) : query;

    public static IOrderedQueryable<T> OrderByIf<T, TKey>(this IQueryable<T> query, bool condition, Expression<Func<T, TKey>> keySelector)
        => condition ? query.OrderBy(keySelector) : query.OrderBy(_ => 0);
}

Example: JwtClaims helper (optional)

using System.Text.Json;

namespace Shared.Common.Security;

public static class JwtClaims
{
    public static string? GetClaim(string jwt, string claim)
    {
        if (string.IsNullOrWhiteSpace(jwt)) return null;
        var parts = jwt.Split('.');
        if (parts.Length < 2) return null;

        static byte[] Parse(string s){ return System.Convert.FromBase64String(s + "==="[(s.Length + 3) % 4..]); }
        var payload = System.Text.Encoding.UTF8.GetString(Parse(parts[1]));
        var doc = JsonDocument.Parse(payload);
        return doc.RootElement.TryGetProperty(claim, out var el) ? el.ToString() : null;
    }
}

Packing tips

• Keep this package free of ASP.NET/EF/MAUI dependencies.
• If a type starts referencing a framework, move it to a framework-specific package (e.g., Shared.WebApi.Server).