Ozcorps.Core 9.0.0

Ozcorps.Core

Ozcorps.Core is a multi-targeted utility package for ASP.NET Core applications. It provides reusable building blocks for response modeling, dynamic query operations, encryption helpers, geometry conversion utilities, and Elasticsearch integration.

Target Frameworks

• net8.0
• net9.0
• net10.0

Installation

dotnet add package Ozcorps.Core --version 9.0.0

What's Included

• Ozcorps.Core.Models.Response<T> and Response
• Dynamic query helpers in Ozcorps.Core.Extensions.QueryExtensions
• Geometry conversion and projection helpers in Ozcorps.Core.Extensions.GeometryExtensions
• Encryption abstractions and implementations (IEncryptor, IFileEncryptor, Md5Encryptor, RsaEncryptor, FileEncryptor)
• Elasticsearch provider and generic service (IElasticSearchProvider, IElasticSearchService<T>)
• Security headers middleware (HeadersMiddleware, HeaderOption)

Response Model

Use a consistent API response contract:

using Ozcorps.Core.Models;

var success = Response<string>.Ok("done", "Operation completed");
var failed = Response<string>.Fail("Validation failed", new Dictionary<string, string[]>
{
    ["Email"] = new[] { "Email is required" }
});

Response<T> includes:

• Data
• Success
• Message
• Errors
• TraceId
• Timestamp

Encryption Services

Register encryption services from DI extensions:

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddRsaEncryptor();
builder.Services.AddMd5Encryptor();
builder.Services.AddFileEncryptor();

Required Configuration

RsaEncryptor expects:

{
  "Rsa": {
    "Public": "base64-public-key",
    "Private": "base64-private-key"
  }
}

Md5Encryptor uses:

{
  "Md5Key": "your-secret-key"
}

Elasticsearch Integration

Register provider and generic service:

using Microsoft.Extensions.DependencyInjection;

builder.Services.AddElasticSearchProvider();

Configuration:

{
  "ElasticSearch": {
    "Host": "http://localhost:9200"
  }
}

Usage:

public class ProductSearchService
{
    private readonly IElasticSearchService<Product> _service;

    public ProductSearchService(IElasticSearchService<Product> service)
    {
        _service = service;
    }

    public IQueryable<Product> Search(string index)
    {
        return _service.Search(index, page: 0, rowCount: 20);
    }
}

Query Extensions

QueryExtensions supports runtime filtering, searching, ordering, and pagination over IQueryable.

Example:

var filtered = query.SearchAnd(
    new[] { "Name", "Status" },
    new[] { "john", "active" },
    new[] { "contains", "==" });

var ordered = filtered.OrderHelper(
    new[] { "asc" },
    new[] { "Name" });

Geometry Extensions

The geometry helpers are based on NetTopologySuite and ProjNet.

Capabilities include:

• WKT/WKB conversions
• Simplification
• SRID transformations (WGS84, WebMercator, TM, UTM variants)

Example:

using Ozcorps.Core.Extensions;

var geometry = "POINT(29.0 41.0)".WktToGeometry();
var mercator = geometry.ToWebMerkator();
var wkt = mercator.ToWkt();

Headers Middleware

HeadersMiddleware allows adding/removing security-related response headers using HeaderOption.

You can configure it in your pipeline by constructing HeaderOption and invoking the middleware.

Notes

• Package metadata includes PackageReadmeFile, and this file is packed into the NuGet package.
• XML documentation file generation is enabled.
• Elasticsearch integration uses the Nest 7.x client.

License

MIT