crestapps-core-aspnet-hosting

CrestApps.Core ASP.NET Hosting

You are a CrestApps.Core expert. Register host services first, compose CrestApps through AddCrestAppsCore(...), then map only the hubs and endpoints for the features the host enables.

Rules

• Packages go in the web project. Pick a provider package, the feature packages, and one store package (CrestApps.Core.Data.EntityCore or CrestApps.Core.Data.YesSql) when records must persist.
• The service registrations are identical for MVC, Razor Pages, Blazor and Minimal APIs; only the UI and endpoint layer differs.
• Add a commit boundary for every write path: AddCrestAppsStoreCommitterFilter() for MVC, .AddSignalR(addStoreCommitterFilter: true) for hubs, StoreCommitterEndpointFilter for Minimal API groups, and an explicit IStoreCommitter.CommitAsync() in background scopes.
• Call UseWebSockets() before UseRouting(). HTTP/2 WebSocket handshakes (extended CONNECT) are otherwise rejected with 405, which breaks the realtime WebSocket transport.
• Call UseAIAnonymousVisitorCookie() (from CrestApps.Core.AI.Chat) after routing and before authentication when anonymous visitors chat, so rate limiting and session reuse get a stable visitor key.
• Every hub type that is mapped needs ConfigureCrestAppsChatHubOptions<THub>() (or ConfigureChatHubOptions<THub>() on the Chat Interactions builder). HubOptions<THub> is per hub type; an unconfigured hub runs on SignalR defaults (one parallel invocation per client), which deadlocks the realtime WebRTC handshake.
• The document and figure endpoints authorize against resources through IAuthorizationService. Register IAuthorizationHandler implementations that grant the requirements, or every download and upload is forbidden.

MVC Program.cs

using CrestApps.Core;
using CrestApps.Core.AI;
using CrestApps.Core.AI.Chat;
using CrestApps.Core.AI.Documents;
using CrestApps.Core.AI.Documents.Endpoints;
using CrestApps.Core.AI.Documents.OpenXml;
using CrestApps.Core.AI.Documents.Pdf;
using CrestApps.Core.AI.OpenAI;
using CrestApps.Core.Data.EntityCore;
using CrestApps.Core.SignalR;
using MyApp.Hubs;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddLocalization();
builder.Services.AddControllersWithViews()
    .AddCrestAppsStoreCommitterFilter();
builder.Services.AddHttpContextAccessor();

Directory.CreateDirectory(Path.Combine(builder.Environment.ContentRootPath, "App_Data"));

builder.Services.AddCrestAppsCore(crestApps => crestApps
    .AddAISuite(ai => ai
        .AddEntityCoreStores()
        .AddOpenAI()
        .AddChatInteractions(chat => chat
            .AddEntityCoreStores()
            .ConfigureChatHubOptions<ChatInteractionHub>())
        .AddDocumentProcessing(documents => documents
            .AddEntityCoreStores()
            .AddOpenXml()
            .AddPdf())
        .AddSignalR(addStoreCommitterFilter: true))
    .AddIndexingServices(indexing => indexing.AddEntityCoreStores())
    .AddEntityCoreSqliteDataStore(
        $"Data Source={Path.Combine(builder.Environment.ContentRootPath, "App_Data", "crestapps.db")}"));

builder.Services.ConfigureCrestAppsChatHubOptions<AIChatHub>();

var app = builder.Build();

await app.Services.InitializeEntityCoreSchemaAsync();

app.UseHttpsRedirection()
    .UseStaticFiles()
    .UseWebSockets()
    .UseRouting()
    .UseAIAnonymousVisitorCookie()
    .UseAuthentication()
    .UseAuthorization();

app.MapHub<AIChatHub>("/hubs/ai-chat");
app.MapHub<ChatInteractionHub>("/hubs/chat-interaction");

app.AddDownloadAIDocumentEndpoint()
    .AddDownloadAIDocumentFigureEndpoint()
    .AddDownloadKnowledgeFigureEndpoint()
    .AddUploadChatInteractionDocumentEndpoint()
    .AddRemoveChatInteractionDocumentEndpoint()
    .AddUploadChatSessionDocumentEndpoint()
    .AddRemoveChatSessionDocumentEndpoint();

app.MapControllerRoute("default", "{controller=Home}/{action=Index}/{id?}");

await app.RunAsync();