Namespace Singulink.Net.Http.Api.Service

Classes

ApiExceptionHandler

Base IApiExceptionHandler implementation that reports ApiException instances as-is, applies application-specific mappings via MapAsync(HttpContext, Exception), and handles unexpected exceptions by logging them with a reference ID and reporting a ServerErrorApiException that includes the reference ID. In development environments unexpected exceptions are propagated instead so that the developer exception page can display them.

ApiExceptionHubFilter

Hub filter that reports exceptions thrown by hub methods (including during enumeration of streamed results) and connection handlers to clients as API errors. Exceptions are mapped using the registered IApiExceptionHandler (if any), so hub exceptions are logged and reported consistently with regular and streaming API responses, and the resulting ApiException is sent to the client in a form that the API client reconstructs as the same exception type.

ApiExceptionMiddleware

Middleware that handles exceptions thrown during request processing by reporting them to the client as API errors. Exceptions are mapped using the registered IApiExceptionHandler (if any); otherwise ApiException instances are reported as-is and other exceptions propagate.

HttpContextExtensions

Extension methods for HttpContext.

HttpSessionContextFactory<TSessionToken, TSessionData>

Factory for creating HttpSessionContext<TSessionToken> instances.

HttpSessionContext<TSessionToken>

Provides an abstraction for handling user sessions and tokens in an HTTP context.

HttpSessionContext<TSessionToken, TSessionData>

Provides methods for handling user session tokens.

HubCallerContextExtensions

Extension methods for accessing the session from a HubCallerContext.

HubClientProxyExtensions

Extension methods for sending HubMessage definitions and invoking HubMethod<TResult> definitions on hub clients.

HubOptionsExtensions

Extension methods for configuring HubOptions.

KeepAlivePingAttribute

Specifies that the streaming response from the endpoint should automatically send a ping record (which requires no special client-side handling) whenever no item has been produced for the specified interval, keeping the response connection alive.

OriginValidator

Validates origins against a list of allowed origins.

ServiceCollectionExtensions

Extension methods for registering HTTP API services in an IServiceCollection.

SessionAccessAttribute

Attribute for configuring options when binding session tokens from HTTP contexts.

SessionContext<TSessionToken>

Provides an abstraction for handling user sessions and tokens.

SessionHandlingOptions

Provides options for configuring session context behavior.

SignInInfo

Contains information about a sign-in request, such as device info, IP address, session expiry, and persistence.

WebApplicationExtensions

Extension methods for configuring WebApplication and its related interfaces to use HTTP API services.

Interfaces

IApiExceptionHandler

Maps exceptions thrown while processing API requests to the errors reported to clients. Used by ApiExceptionMiddleware for regular responses and by streaming responses for exceptions thrown after the stream has started, so a single implementation provides consistent error handling (e.g. logging unexpected exceptions and reporting a reference ID) for both.

IHttpSessionContextFactory<TSessionToken>

Represents a factory for creating HttpSessionContext<TSessionToken> instances.

IOriginValidator

Provides validation to determine whether an origin is allowed.

ISessionStoreContextFactory<TSessionToken, TSessionData>

Represents a factory for creating ISessionStoreContext<TSessionToken, TSessionData> instances.

ISessionStoreContext<TSessionToken, TSessionData>

Represents a session data storage context used for managing session tokens and associated data.

ISessionToken

Represents a session token that contains user information and the last time it was refreshed.

Enums

SessionAccessOptions

Options for configuring session access behavior.