Themia.Storage.Configuration 0.48.0

Themia.Storage.Configuration

One configuration shape for storage, shared by every app. AddThemiaStorageFromConfiguration reads the Storage section, registers the app's IStorageProvider (and IStorageUrlService), and stops the host at start when the configuration is wrong.

builder.Services.AddThemiaStorageFromConfiguration(builder.Configuration);

Private files are always on Local. Every key outside public/ goes to the Local provider, and nothing in the configuration can change that: Storage:Private:Provider accepts Local or nothing, and Storage:Provider=S3 is refused. The public slot (public/... keys) is Local, or S3/R2 with Storage:Public:Provider. With S3/R2 the provider is a SplitStorageProvider whose S3 side is public-only and has no private bucket.

The package references Themia.Storage.S3, so a Local-only app restores AWSSDK.S3 too.

Keys

A relative path is under the content root. In an environment variable : is __.

Refused at start: an unknown key under Storage:S3, Storage:Local, Storage:Public or Storage:Private; Storage:S3:* with a Local public slot; Storage:Local:PublicRootPath/PublicBaseUrl with an S3/R2 public slot; a public root inside the private root's blobs/content-types directory (or the reverse). Messages name the key and never a value. The root checks compare paths, not symlinks or junctions: a link from one root into the other is not caught.

Deprecated keys (read with a startup warning)

Removed in the first release after every adopting app has switched; the CHANGELOG announces it.

Setting an old key together with its new one is refused (DownloadBaseUrl may repeat the same value). Storage:S3:BucketName is not accepted: it is now Storage:S3:PublicBucketName, and there is no private bucket. RootPath has no default; an app that relied on the uploads default sets Storage:Local:RootPath=uploads. SigningKey is required even with a Local-only public slot.

Per app: old key → new key

Copy the app's block into its adoption runbook. Names are environment variables.

Propertiezy (today Split)

EzyAssets

EzyServices (Local only)

CDN purge and the Local endpoints

Purge. With an S3/R2 public slot, the binding wraps that slot with PurgingStorageProvider when an ICdnPurger is registered (AddThemiaStorageCloudflarePurge, in any order relative to this call). Deleting a public/ key then purges its public URL; private keys are never purged. Do not wrap the public slot yourself and do not register your own IStorageProvider next to this binding: the host stops at start. A Local public slot is not wrapped (the resolved provider stays a LocalStorageProvider, which apps cast to map the public mount).

Signer. The binding registers the LocalUrlSigner that MapThemiaLocalStorage verifies with, built from Storage:Local:SigningKey (TryAdd: a signer you register yourself is kept). Drop your own registration once you are on the binding; a signer built from a different key makes every presigned link 403.