CoreSystem.Http 1.0.0

🌐 CoreSystem.Http

Build HTTP features once. Reuse them everywhere.

Reusable HTTP infrastructure for ASP.NET Core and .NET 8.

CoreSystem.Http provides reusable infrastructure for capturing and replaying HTTP responses in ASP.NET Core applications. It offers lightweight, dependency-free components that simplify response interception while promoting code reuse across middleware, pipelines, and application frameworks.

Designed as a foundational building block, CoreSystem.Http can be used by caching, idempotency, auditing, logging, security, or any feature that requires capturing or reproducing HTTP responses.

✨ Features

• ✅ HTTP response capture
• ✅ HTTP response replay
• ✅ Response body buffering
• ✅ Header preservation
• ✅ HEAD request support
• ✅ Lightweight and dependency-free
• ✅ Built for ASP.NET Core
• ✅ Reusable across multiple frameworks and libraries

📦 Installation

dotnet add package CoreSystem.Http

🚀 Quick Start

Register CoreSystem.Http:

builder.Services.AddCoreHttp();

Inject the required services:

public sealed class MyHandler(
    IResponseCapture responseCapture,
    IHttpResponseWriter responseWriter)
{
}

Capture an HTTP response:

CapturedResponse response =
    await responseCapture.CaptureAsync(
        context,
        next);

Replay the captured response:

await responseWriter.WriteAsync(
    context,
    response);

📖 Public API

CoreSystem.Http intentionally exposes a small and focused public API.

🏗 Architecture

Application
      │
      ▼
IResponseCapture
      │
      ▼
ResponseCapture
      │
      ▼
CapturedResponse
      ▲
      │
HttpResponseWriter
      │
      ▼
HttpResponse

🎯 Use Cases

CoreSystem.Http serves as reusable infrastructure for features such as:

• HTTP response caching
• Idempotency
• Audit logging
• Response transformation
• API gateways
• Reverse proxies
• Middleware development
• Custom ASP.NET Core frameworks

📚 Documentation

The full documentation includes:

• Getting Started
• Architecture
• Dependency Injection
• Response Capture
• Response Replay
• Extensibility
• Best Practices

Visit the GitHub repository for the complete documentation.

🤝 Contributing

Issues, discussions and pull requests are welcome.

📄 License

Released under the MIT License.