javier
cdded06ba3
This PR contains the work done to rename the _Web_ package as _Infrastructure_, to provide a clear naming and purpose to this particular package within the project. To provide further details about the work: * Infrastructure * Asset fingerprinting: an FNV-1a token derived from the static files directory, appended as ?v= to asset URLs so deploys bust caches; pre-rendered pages also revalidate via weak ETags. * New middlewares: fixed-window RateLimitMiddleware (per-client budgets keyed by trusted X-Forwarded-For or remote address) and VaryMiddleware (Accept-Encoding on every response); SecurityHeadersMiddleware now also stamps error responses. * Auto-generated HEAD endpoints, cache max-age configuration, and Docker build/Compose refinements. * Protocols and scaffolding: Asset/AssetExtension, the Page protocol (viewport, stylesheets, scripts, versioned URLs), and LocalizedRequestContext. * Rate limiter's counter store swapped from an actor to a Mutex (no executor hop per request) with amortized batch eviction instead of O(n²) scans under client floods. * FingerprintAssets reports unreadable files to a logger instead of silently producing a token that never busts their cache. Reviewed-on: rock-n-code/loud-amsterdam#25 Co-authored-by: Javier Cicchelli <javier@rock-n-code.com> Co-committed-by: Javier Cicchelli <javier@rock-n-code.com>
54 lines
1.3 KiB
Swift
54 lines
1.3 KiB
Swift
/// A file extension used by an ``Asset``.
|
|
///
|
|
/// Each case's raw value is the extension itself (e.g. `"css"`), which an asset appends to its
|
|
/// file name when resolving paths.
|
|
public enum AssetExtension: String, Sendable {
|
|
/// A Cascading Style Sheets file.
|
|
case css
|
|
/// A JavaScript file.
|
|
case js
|
|
/// A Portable Network Graphics image.
|
|
case png
|
|
/// A Windows icon image.
|
|
case ico
|
|
/// A Scalable Vector Graphics image.
|
|
case svg
|
|
/// A plain text file.
|
|
case txt
|
|
/// A web application manifest file.
|
|
case webmanifest
|
|
/// An Extensible Markup Language file.
|
|
case xml
|
|
}
|
|
|
|
// MARK: - Extensions
|
|
|
|
public extension AssetExtension {
|
|
|
|
// MARK: Computed
|
|
|
|
/// The file's content type.
|
|
var contentType: String {
|
|
switch self {
|
|
case .css: "text/css"
|
|
case .js: "text/javascript"
|
|
case .png: "image/png"
|
|
case .ico: "image/vnd.microsoft.icon"
|
|
case .svg: "image/svg+xml"
|
|
case .txt: "text/plain"
|
|
case .webmanifest: "application/manifest+json"
|
|
case .xml: "application/xml"
|
|
}
|
|
}
|
|
|
|
/// The sub-directory within the static root that holds files with this extension, if any.
|
|
var subdirectory: String? {
|
|
switch self {
|
|
case .css: "css"
|
|
case .js: "js"
|
|
default: nil
|
|
}
|
|
}
|
|
|
|
}
|