Ozcorps.Core 9.1.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
• Elasticsearch provider and generic service (IElasticSearchProvider, IElasticSearchService<T>)
• Security headers middleware (HeadersMiddleware, HeaderOption)
• Encryption abstractions and implementations → moved to Ozcorps.Security

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

Deprecated. All encryption types (IEncryptor, IFileEncryptor, RsaEncryptor, Md5Encryptor, FileEncryptor) have been moved to the Ozcorps.Security package and are marked [Obsolete] here. They will be removed in the next major version.

dotnet add package Ozcorps.Security

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();

Middlewares

ExceptionHandlingMiddleware

Catches unhandled exceptions globally and returns structured JSON error responses.

Register in your pipeline:

app.UseExceptionHandling();

HeadersMiddleware

Adds or removes security-related HTTP response headers via HeaderOption.

var headerOption = new HeaderOption
{
    ReferrerPolicy = "no-referrer",
    XContentTypeOptions = "nosniff",
    XFrameOptions = "DENY",
    XXssProtection = "1; mode=block",
    XPermittedCrossDomainPolicies = "none",
    ContentSecurityPolicies = new List<string> { "default-src 'self'" },
    FeaturePolicies = new List<string> { "camera 'none'" },
    HeadersToRemove = new List<string> { "Server", "X-Powered-By" }
};

app.UseMiddleware<HeadersMiddleware>(headerOption);

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