FileHub.Core 1.0.0-beta.1

FileHub.Core

Sandboxed file-manager building blocks for ASP.NET Core: a pluggable storage abstraction, path/traversal security, chunked upload session management, image thumbnail generation, and Office-document-to-PDF conversion.

This package is the reusable engine behind FileHub.WebDemo, a full working ASP.NET Core MVC file manager built on top of it — that project is the best reference for wiring these pieces into your own app.

Install

dotnet add package FileHub.Core

Requires an ASP.NET Core host — the package references Microsoft.AspNetCore.App (used for MIME-type detection).

What's in the box

• Abstractions/ — IFileSystemProvider, FileSystemItem: the storage abstraction. Implement this interface for a different backend (Azure Blob, S3, ...); PhysicalFileSystemProvider is the built-in local-disk implementation.
• Security/ — PathValidator (traversal / absolute-path / symlink-escape protection) and FilenameSanitizer. Every provider operation should resolve through PathValidator before touching disk.
• Roots/ — RootFolder, RootFolderOptions, RootFolderProvider: binds configuration into runtime root definitions (name, physical path, permissions, upload limits, extension allow/deny lists).
• Permissions/ — PermissionFlags (browse/upload/download/create/rename/ move/copy/delete).
• Uploads/ — UploadSessionManager: chunk staging + assembly for large uploads.
• Thumbnails/ — ThumbnailService: SkiaSharp-based image thumbnails, disk-cached, keyed by root + path + last-modified.
• Conversion/ — IOfficeConversionService / LibreOfficeConversionService: shells out to soffice --headless --convert-to pdf, disk-cached, per-cache-key locking. Requires LibreOffice installed on the host machine (configure its path via LibreOfficeOptions.ExecutablePath).
• Preview/ — PreviewFileClassifier: which extensions need office conversion vs. streaming as-is.

Quick start

using FileHub.Core.Conversion;
using FileHub.Core.Roots;
using FileHub.Core.Thumbnails;
using FileHub.Core.Uploads;
using Microsoft.Extensions.Options;

builder.Services.Configure<RootFolderOptions>(
    builder.Configuration.GetSection(RootFolderOptions.SectionName));
builder.Services.AddSingleton<IRootFolderProvider, RootFolderProvider>();

builder.Services.AddSingleton(new UploadSessionManager(
    Path.Combine(builder.Environment.ContentRootPath, "App_Data", ".uploads")));

builder.Services.AddSingleton(new ThumbnailService(
    Path.Combine(builder.Environment.ContentRootPath, "App_Data", ".cache", "thumbnails")));

builder.Services.Configure<LibreOfficeOptions>(
    builder.Configuration.GetSection(LibreOfficeOptions.SectionName));
builder.Services.AddSingleton<IOfficeConversionService>(sp =>
    new LibreOfficeConversionService(
        Path.Combine(builder.Environment.ContentRootPath, "App_Data", ".cache", "office-pdf"),
        sp.GetRequiredService<IOptions<LibreOfficeOptions>>()));

Then bind root folders under a FileHub:Roots configuration section — see the FileHub.WebDemo sample for a complete controller wiring these services into browse/upload/ download/preview endpoints.

License

MIT — see LICENSE.