DocuTrust.NET 1.0.1

DocuTrust.NET 🛡️

Accelerate your .NET file handling with confidence.

<p align="center"> <img src="https://github.com/user-attachments/assets/e7a6dc47-ab26-41e7-b3cf-ab805e570631" width="400" alt="DocuTrust.NET Logo" /> </p>

<p align="center"> <img src="https://img.shields.io/badge/License-Attribution%201.0-blue.svg" alt="License"> <img src="https://img.shields.io/badge/.NET-8.0-purple.svg" alt=".NET Version"> <a href="https://www.nuget.org/packages/DocuTrust.NET/"> <img src="https://img.shields.io/nuget/v/DocuTrust.NET.svg" alt="NuGet"> </a> </p>

Why DocuTrust.NET?

Every time I started a new .NET project, I found myself wiring up the same libraries — PDF reading, Word documents, file validation. After doing this twice in real projects, I decided to wrap them into a single cohesive library so I (and others) never have to repeat that setup again.

Built by Saud Saad Al-Rashidi, a Health Informatics student at SEU, DocuTrust.NET is born from real-world requirements to simplify file security and content extraction.

Features

• File Signature Validation: Verify files by magic bytes, not just extensions.
• Hardened PDF Scanning: Deep behavioral analysis to detect embedded JavaScript and malicious structural anomalies.
• Office Document Intelligence: Scan both modern (OpenXML) and legacy (OLE) Word, Excel, and PowerPoint files for VBA macros, DDE fields, and suspicious external links.
• Content Extraction: Easy-to-use API for pulling text out of PDFs and Office documents.
• ASP.NET Core Ready: Seamless dependency injection integration.

Installation

dotnet add package DocuTrust.NET

Quick Start

using DocuTrust.Extensions;
using DocuTrust.Core.Abstractions;

// 1. Register in Program.cs
builder.Services.AddDocuTrust();

// 2. Inject and Use
public class MyService(IDocuTrustFileValidator validator)
{
    public async Task CheckFile(IFormFile file)
    {
        var result = await validator.ValidateFileAsync(file, ".pdf");
        if (result.IsValid)
        {
            Console.WriteLine($"Validated: {result.ActualMimeType}");
        }
    }
}

Documentation

• Getting Started
• Usage Guide
• API Reference
• Design Philosophy

Dependencies

• UglyToad.PdfPig
• DocumentFormat.OpenXml
• FileSignatures

License

DocuTrust.NET is licensed under the DocuTrust Open Attribution License v1.0. Commercial use is permitted, provided that attribution is given:

Uses DocuTrust.NET by sa3od34ki@gmail.com

Contact

Developed by Saud Saad Al-Rashidi
Email: sa3od34ki@gmail.com