Skip to content
fabricators docs
On this page

Changelog

v0.15.0

Stable

Release 0.15.0

  • Add explicit same-identity OIDC reauthentication with fresh signed auth_time, opt-in provider capability and live product admission/completion ports. Add primary StepUp proofs and policy-admitted TOTP/passkey freshness renewal from existing sessions, preserving session families and rejecting assurance downgrade.

  • Recheck current maximum authentication age when redeeming proofs. Require an explicit existing-session policy for stale-primary passkey/TOTP step-up; reject Local-kind DateTime in the legacy stored-UTC presentation helper instead of silently re-tagging wall-clock time.

  • Supply explicit invariant process/JSON defaults, UTC instant normalization, offset-qualified timestamp input and strict JSON numbers. Keep business dates and presentation cultures explicit and separate from technical contracts.

  • Add scoped locale/timezone negotiation and explicit display formatting without changing technical culture. Supply runtime app catalog ports and immutable, namespace/revision-bound composition with optional tenant overrides.

  • Add shared one-based page, half-open positional range and cursor pagination contracts, endpoint policies, strict optional HTTP query parsing and bounded look-ahead result builders with optional long totals. Keep legacy PagedResult wire compatibility and the pure Kernel free of EF/ASP.NET dependencies.

  • Document existing confirmation wire contracts versus IC's product-owned challenge enforcement, and assess combinable typed-resource confirmation and recent authentication without claiming a generic implementation.

  • Generate and verify the full documentation bundle only in the macOS CI job, retaining it as a commit-bound workflow artifact. Keep documentation unit tests and installed-tool startup checks on Windows/Linux without repeated full exports.

v0.16.0

Stable

Release 0.16.0

  • Check optional diagnostic disclosure quietly against current product permissions, without authorization-failure noise on ordinary responses. Keep real endpoint denial logging and preserve application caching by omitting private diagnostic headers on cacheable/revalidating responses.
  • Retain EF command failures and ASP.NET hosting errors, including startup exceptions. Keep successful SQL and raw request events suppressed by default; expose an explicit raw-request logging opt-in.
  • Resolve parent-language overrides consistently, add recorded non-strict fallback and opt-in system-resolvable timezones, including canonical case-insensitive zone lookup. Malformed overrides remain invalid in either mode.
  • Separate bounded template source/model/output/loop budgets and support larger digest models by default. Add all-or-nothing digest composition that splits model/output budget failures into numbered parts without sending or truncation.
  • Preserve safe SMTP TLS/socket/protocol diagnostics through submission and connection verification, without raw server replies or credential-bearing inner exceptions. Subject cleanup remains a consumer responsibility.

v0.17.0

Stable

Release 0.17.0

  • Make trusted template rendering budgets independently configurable without the former fixed upper ceilings. Replace the fixed text/HTML body ceiling with exact MIME byte budgets for SMTP and Graph, optionally tightened per connection.
  • Enforce SMTP's advertised SIZE before the envelope and Graph's write-request ceiling including Base64 expansion. Report MessageTooLarge with safe size metadata; never split, truncate, queue, retry or pace submissions automatically.
  • Clarify that campaigns, consent/unsubscribe content, mailing lists, durable queues and pacing belong to consuming applications.

v0.18.0

Stable

Release 0.18.0

  • Add an opt-in module-facing shared DbContext factory and ordered immutable model compositions with revision/variant fingerprints and design-time-aware EF keys.
  • Add independent presentation response-header/Vary controls and a trusted error response callback with sanitized metadata, preserving current defaults and strict malformed-input rejection. Preserve application headers when emission is disabled.
  • Preserve explicit DateTimeOffset response offsets while keeping strict UTC-normalized input. Add an explicit UTC-only JSON output policy and document the unchanged UTC-kind requirement for DateTime output, including EF-loaded Unspecified values.
  • Keep IC pagination parsing, normalization, defaults and HTTP mapping consumer-owned; no pagination contract changes or automatic request-zone conversion are introduced.

v0.19.0

Stable

Release 0.19.0

  • Add opt-in native OIDC challenges/token exchange with explicit per-client audience/authorized-party lists and raw/SHA-256-hex nonce policies. Reuse durable one-use intents and current product login/link/reauthentication completion.
  • Add authenticated BFF transport with a fixed public origin/prefix, public callbacks and cookie-free native completion; retain strict web code flow.
  • G-01: add explicit request-zone DateTimeOffset JSON output and a reusable strict converter. Preserve existing offset/UTC-only policies when not opted in.
  • G-03: document authentication-before-presentation ordering and add an optional runtime guard. Anonymous hosts retain their existing middleware default.
  • G-04 (improvement): separate timestamp and number configuration. Date-only adoption can preserve the consumer's existing quoted-number handling.
  • G-05: expose HTTP-request presence, opt-in missing-request rejection and an ITimeZoneContext adapter over the same presentation snapshot. HTTP-zone JSON rejects missing request/middleware; jobs must explicitly select preferences.
  • G-06: document EF UTC-kind mapping and DateTimeOffset response contracts; DateTime output validation and UTC-only DateTime serialization are unchanged.
  • G-07: document private caching for user-derived preferences and cache keys based on the effective locale/timezone, rather than assuming Vary isolates users.
  • G-08: explicit non-strict overrides now fall back for malformed values too, with safe debug logging and fallback flags. Strict defaults remain unchanged.
  • Start package publication only after exact-commit main CI succeeds. Tag-first runs defer to CI completion without polling or holding a publishing runner.

v0.10.0

Stable

Release 0.10.0

  • Add personal user API tokens and confidential machine client credentials, distinct from interactive sessions and legacy consumer API keys.
  • Add a bounded client-credentials exchange, scoped bearer authentication and current owner/parent admission, expiry and revocation through product-owned durable stores.
  • Add per-credential IPv4/IPv6/CIDR policies enforced on exchange and every protected request, with explicit direct-socket or authenticated-BFF address provenance.
  • Add credential/network/HTTP conformance and packaged-consumer checks; include cross-platform TLS and lifecycle fixture corrections from the preceding increment.

v0.11.0

Stable

Release 0.11.0

  • Separate fresh-session admission (LoginRequiredAssurance) from ongoing session and refresh policy, so enabling MFA can require stronger new logins while preserving already established sessions.
  • Add explicit degraded recovery-session admission (AllowRecoverySessions), with sensitive-operation restrictions remaining the product's responsibility.
  • Add PostgreSQL and policy tests for stronger new-login requirements, established session/refresh retention and explicitly authorized recovery assurance.

v0.12.0

Stable

Release 0.12.0

  • Add per-SMTP-connection strict, revocation-only relaxation and explicit insecure certificate policies for development/internal hosts. Required TLS remains in force; connected mail preserves the trusted profile's selection.
  • Keep the .NET/EF baseline on 10 by product decision: SDK 10.0.404 and Microsoft libraries 10.0.15. Refresh stable dependency pins and lockfiles, including MailKit/MimeKit 5, Swashbuckle 11, OpenTelemetry 1.21 and CSharpier 1.4.
  • Cache bounded parsed Scriban templates privately per process, with configurable capacity/lifetime and local stampede protection; isolate every rendering context.
  • Cache approved-assembly handler/endpoint metadata with weak assembly keys and module ordering per composed host. Reject ambiguous handlers and invalid module names; keep raw exception messages and objects out of handler logs.
  • Add AddFoundationHandlers for command and query handlers from approved assemblies, with optional validation and logging decorators for all three handler shapes. Validation failures are ValidationError entries of ErrorType.Validation. Repeated calls never decorate a handler twice.
  • Add IEndpoint, AddEndpoints(approvedAssemblies) and MapEndpoints() to Fabricators.Kernel.AspNetCore; endpoints map onto the app or a route group.
  • Add ModuleOrder.Sort, AddModules and MapModules: modules run in dependency order; an unknown or cyclic dependency or a duplicate module name fails startup.
  • Add IModuleModel and ModelBuilder.ApplyModuleModels to Fabricators.Infrastructure so modules contribute to a shared EF model.

v0.13.0

Stable

Release 0.13.0

  • Capture response-start timing totals and phases from one monotonic instant before asynchronous disclosure checks. Require a separate opt-in for passwords or OAuth credentials on every unencrypted SMTP connection, including loopback.
  • Add explicit trusted-relay plaintext SMTP, while keeping mandatory TLS defaults, and classify standalone SMTP failures without exposing raw MailKit replies.
  • Add template-owned HTML escaping as an explicit rendering mode, named timing phases with policy-gated JSON adaptation, configurable OpenAPI routes/filter registration, classic worker observability and a configurable console sink.
  • Keep legacy encrypted-record and template migrations product-owned; Foundation does not add legacy cryptographic profiles or decryption fallback.
  • Add provider-neutral scoped secret protection and optional Data Protection/EF key-ring adapters. Require explicit persistence and certificate-protected keys by default, with retained certificates for planned rotation.
  • Add SMTP connection verification without submitting mail, including a separate verification capability, runtime settings resolution and shared TLS/auth logic. Recheck connection authority before credential resolution and before network I/O.
  • Enable NuGet package caching in Foundation CI and Publish; independent package consumers keep their isolated package caches and local freshly packed feed.

v0.14.0

Stable

Release 0.14.0

  • Add provider-neutral permission definitions/catalog, trusted actor/resource binding and current authorization ports, with optional ASP.NET requirements. Missing adapters and unknown capabilities deny; roles and assignments remain product-owned. Start with the Foundation diagnostic disclosure capability.
  • Require explicit environment enablement and current permission through UseFoundationRequestDiagnostics. Disable implicit Development timing in the low-level middleware and mark disclosed timing responses as non-cacheable.
  • Require successful main CI for the exact tagged commit before publication. Publish now restores/builds/packs without repeating formatting, tests or independent consumer checks; manual runs also require a matching release tag.

v0.9.0

Stable

Release 0.9.0

  • Add an optional maintained OIDC code-flow bridge and Google, Apple and explicit Microsoft directory profiles, without product users, linking or automatic sessions.
  • Require durable, browser-bound one-use intents and product-owned completion; discard provider tokens and keep OIDC identity separate from local MFA assurance.
  • Add short-lived Apple ES256 client-secret signing from runtime-owned keys.
  • Add controlled HTTPS discovery/token/signature and adversarial callback fixtures.

v0.6.0

Stable

Release 0.6.0

  • Add optional cache, observability, HTTP/EF timing, OpenAPI, realtime, cron, SMTP, templating and validation adapters with provider-neutral application ports.
  • Preserve the Infrastructure cache facade and move its implementation into an EF-free adapter. Keep existing Kernel/Application dependency boundaries.
  • Add progressive typed MCP discovery/calling, mandatory host authority contracts and authenticated stateless HTTP. Package a separate readonly developer-docs MCP.
  • Add a selected StyleCop authoring profile, formatter templates and a reusable Roslyn layout-check tool for first-party and third-party app developers.
  • Centralize the target framework, enable transitive version pinning, lock restores and verify actual NuGet consumers/tools in the shared CI/release gate.
  • Pin the SMTP dependency's PKCS transitive package to patched 10.0.14.

v0.7.0

Stable

Release 0.7.0

  • Add optional strong-authentication orchestration, native ASP.NET Core WebAuthn, TOTP, recovery codes, assurance and separate EF persistence configurations.
  • Keep authority, policy, admission limits, key management and migrations explicit host responsibilities. No method is enabled by default.
  • Add opaque interactive sessions for browser/PWA and Capacitor iOS/Android, atomic proof exchange and refresh, bounded retry recovery, current policy/epoch validation, per-device/global revocation and idempotent security-event invalidation.
  • Add protected cookie/CSRF and native bearer/binding transports, explicit CORS and app-association metadata with approved Android signing-certificate origins.
  • Verify real SQLite/PostgreSQL concurrency, audit rollback and populated-schema upgrades; add a PostgreSQL CI service job and SDK-only test orchestration.
  • Clean unused imports and enforce IDE0005 in source and installed authoring consumer checks without requiring XML documentation on every public symbol.
  • Add headless documentation contracts and a .NET export tool. Prepare foundation's own authored guides, compiled public API reference, navigation/search, source examples, JSON authoring schema and agent discovery index before any frontend.
  • Use Cloudflare, Stripe and rfw as content/experience references; defer the visual renderer, ERP app composition and OpenAPI imports to separate integrations.
  • Extend verification with transactional authentication/replay tests, native software WebAuthn fixtures and independently installed documentation tooling.

v0.7.1

Stable

Release 0.7.1

  • Preserve established sessions during routine factor enrollment/removal and recovery-code regeneration. Fence pending challenges/completions with a separate credential revision; global factor-change revocation is an explicit host policy.
  • Add authenticated other-session revocation, preserving the caller's family and refresh credentials while fencing pending proofs. Enforce host-selected assurance, freshness and individual/other/global revocation permissions.
  • Add opt-in encrypted login information: observed user agent/server-resolved IP, client device/version labels and consent-declared, unverified GPS coordinates. No capture is enabled by default and none of these fields establish identity.
  • Add an additive nullable metadata mapping with EF-generated populated 0.7.0 upgrade/rollback tests. Existing live sessions remain usable after migration.

v0.8.0

Stable

Release 0.8.0

  • Add provider-neutral mail connections, runtime token leases and future mailbox reading contracts without a reader, synchronization worker or attachment fetch.
  • Add shared MIME/dispatch and a separate scoped Microsoft Graph adapter; retain legacy SMTP APIs and add connected SMTP password/XOAUTH2 with current admission.
  • Add optional Cc/Bcc/reply/thread data without changing existing constructors; redact mail/token state and classify uncertain sends without automatic retries.
  • Add loopback HTTP/SMTP conformance and independent packaged-consumer coverage.

v0.4.0

Stable

Release 0.4.0

  • Require .NET 10; update the SDK, Microsoft libraries, FusionCache and test tooling to stable releases.
  • Add an enforcing antiforgery gate for JSON writes, anonymous endpoint opt-in and reviewed opt-out. Cover inline/fallback authorization policies and identity-bound token re-minting in integration tests.
  • Add authenticated BFF visitor-IP resolution with configurable protocol headers, startup validation, proof-header removal and no implicit trust in Cloudflare or X-Forwarded-For headers.
  • Make API-key rate limiting use the same resolved address and IPv6 /64 partitioning. The legacy boolean overload remains source-compatible but no longer trusts raw Cloudflare headers.
  • Cap Email input at 320 characters and match it with a non-backtracking generated regex, so pathological input can no longer stall validation.
  • Document consumer middleware order, BFF obligations and incremental adoption in Platform/live-studio.

This is a breaking consumer upgrade from 0.3.x. Consumers must target .NET 10, recompile, configure the BFF trust boundary and explicitly wire the new middleware. Package publication and consumer deployment are separate steps; changing this source does not update Platform.

v0.5.0

Stable

Release 0.5.0

  • Add FieldValidationError, RetryAfterError, LimitExceededError and ImpersonationRefusedError as kernel error subtypes, declared on Error so they serialize without ErrorPolymorphism.Register. Their wire shape matches influencer.camp's (same members, codes and descriptions).
  • Answer RetryAfterError with 429 and a Retry-After header from ToApiResult.
  • Add Slug and ItalianTaxIds validators in Fabricators.Kernel.Validation: kebab-case slugs, codice fiscale shape and check character, partita IVA check digit. Length is checked before a non-backtracking generated regex.
↑ ↓ to move↵ to openSearching fabricators .NET foundation v0.19.0