Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[Unreleased]

[10.8.0] — 2026-06-24

Added

• AsCatalog() — deserializes the "catalog" archetype into CatalogInfo
• AsSchedule() — deserializes all "schedule" archetypes into List<ScheduleInfo>
• AsGallery() — deserializes the "gallery" archetype into GalleryInfo
• AsStringList(name?) — deserializes a "stringlist" archetype into StringListInfo
• New SDK models: CatalogInfo, ScheduleInfo, GalleryInfo, GalleryImage, StringListInfo

Removed (BREAKING)

• FromPoco<T>() — use AsCustomData<T>()
• FromCustomList<T>() — use AsCustomList<T>()
• GetAvailableCalendarSlots() — use AsAvailableSlots()
• GetLocalizedFields() — use AsLocalized()
• Get<T>(typeDiscriminator) — use the typed As*() methods (e.g. AsCatalog(), AsGallery())
• GetAll<T>(typeDiscriminator) — use AsSchedule() or AsCustomList<T>()

Changed

• Simplified AsAvailableSlots() internals — same behavior, less code

Migration from 10.7.0

- resource.FromPoco<MyType>()
+ resource.AsCustomData<MyType>()

- resource.FromCustomList<MyRow>()
+ resource.AsCustomList<MyRow>()

- resource.GetAvailableCalendarSlots()
+ resource.AsAvailableSlots()

- resource.GetLocalizedFields("en")
+ resource.AsLocalized("en")

- resource.Get<CatalogInfo>("catalog")
+ resource.AsCatalog()

[10.7.0] — 2026-06-23

Added

• AsCatalog() — deserializes the "catalog" archetype into a typed CatalogInfo
• AsSchedule() — deserializes all "schedule" archetypes into a list of ScheduleInfo entries
• AsGallery() — deserializes the "gallery" archetype into a typed GalleryInfo with images
• AsStringList(name?) — deserializes a "stringlist" archetype by name into StringListInfo
• AsCustomData<T>() — renamed from FromPoco<T>(), deserializes "custom" archetype fields into a typed object
• AsCustomList<T>() — renamed from FromCustomList<T>(), deserializes "customlist" archetype rows into a typed array
• AsLocalized(locale) — gets localized fields for a specific language from CmsResource or PublishedResource
• AsAvailableSlots() — renamed from GetAvailableCalendarSlots(), returns available calendar time slots

Changed

• BREAKING: Consolidated Cms.LightSdk.Extensions.CmsResourceExtensions into Cms.LightSdk.CmsResourceExtensions — update using directives from using Cms.LightSdk.Extensions; to using Cms.LightSdk;

Deprecated

• FromPoco<T>() — use AsCustomData<T>() instead
• FromCustomList<T>() — use AsCustomList<T>() instead
• GetAvailableCalendarSlots() — use AsAvailableSlots() instead
• GetLocalizedFields() — use AsLocalized() instead

Added

• DiskCachePath option on CmsClientOptions — path to SQLite .db file for FusionCache L2 disk cache

Changed

• CmsClient is now a pure stateless HTTP client — removed internal ConcurrentDictionary cache. All caching is handled by CachedCmsClient (FusionCache L1+L2) or by the consumer. (!42, #53)
• FileCachePath is now obsolete — use DiskCachePath instead (backward-compatible property shim)
• CloneWithArchetypes changed from private to internal for reuse by CachedCmsClient

Fixed

• n/a

Removed

• Internal ConcurrentDictionary<string, CacheEntry> cache and CacheEntry record — eliminated double-caching when used with CachedCmsClient (!42, #53)
• LoadFromFileCache() and SaveToFileCache() methods — disk caching is now handled by FusionCache's L2 SQLite layer (!42, #53)

[10.3.1] — 2026-04-14

Added

• CmsResourceExtensions.FromPoco<T>() — deserializes a custom archetype's fields into a typed object, unwrapping { value, label } envelopes

Fixed

• FromPoco<T>() now reads from the correct "fields" property key (was "data") to match the read-only API's ProjectFreeForm output shape

[10.3.0] — 2026-04-14

Added

• CmsResourceExtensions.FromCustomList<T>() (Cms.LightSdk.Extensions) — deserializes a customlist archetype's rows directly into a typed array, unwrapping the { value, label } envelope produced by the read-only API
• WrappedValueConverterFactory (Cms.LightSdk.Serializers) — JsonConverterFactory that transparently unwraps { "value": ... } shaped JSON properties into plain CLR values during deserialization

[10.2.0] — 2026-04-14

Changed

• GetResourceAsync now fetches from the read-only endpoint (/read-only/{tenant}/{site}/{slug}) instead of the internal paginated list endpoint, returning full projected archetype data

Fixed

• CmsArchetype.Type now correctly deserializes from the read-only API's "type" JSON property (removed [JsonPropertyName("$type")])
• CloneWithArchetypes now copies SiteSlug to the returned resource; previously GetResolvedResourceAsync and GetBestMatchAsync always returned an empty SiteSlug

[10.1.0] — 2026-07-16

Changed

• GetResourceAsync updated to use tenant-scoped route (/api/tenants/{tenantSlug}/resources)

[10.0.0] — 2025-07-14

Changed

• Version scheme now follows ASP.NET major version for consistency (10.0.x = .NET 10)