Elsa Studio 3.7.0
Compare: 3.6.1...3.7.0
⚠️ Breaking changes / upgrade notes
- Authentication contracts:
IAuthenticationProvider,IAuthenticationProviderManager, andTokenNamesmoved out ofElsa.Studio.CoreintoElsa.Studio.Loginnamespaces. Consumers importing these APIs fromElsa.Studio.Coreshould update package references/usings toElsa.Studio.Login. (2192884) (#723) - UI dependencies:
MudBlazorwas upgraded from8.15.0to9.0.0,Radzen.Blazorfrom8.3.5to9.0.5, andCodeBeam.MudBlazor.Extensionsfrom8.3.0to9.0.0-rc.1. Applications customizing Elsa Studio UI components should validate compatibility with these major versions. (04b858a) (#760)
✨ New features
Authentication
- Modern authentication modules: Added a new authentication framework with dedicated Elsa Identity and OpenID Connect modules for Blazor Server and Blazor WASM hosts, including token providers, JWT accessors, unauthorized components, and SignalR connection option configurators. (2192884) (#723)
- Elsa Identity UI feature: Added
ElsaIdentityUIFeatureand switched the WASM host default authentication provider from legacyElsaLogintoElsaIdentity. (7ffc15a) - Legacy Elsa Login compatibility: Added explicit legacy
ElsaLoginsupport for WASM host configuration, preserving an upgrade path for existing host apps. (8612d5b)
Workflow instance diagnostics
- Activity call stack visualization: Added
IActivityExecutionService.GetCallStackAsync, anActivityCallStackcomponent, execution details drawer, and activity selection/highlighting in the workflow instance viewer. (691d373) (#750) - Incident count badge: Displays incident counts on the workflow instance details
Incidentstab. (b3ca85f) (#739) - Pending instance filter: Added
Pendingas a workflow instance sub-status filter and updated translations. (9af41ae) (#737)
Extensibility and UI composition
- Custom theme provider: Added
IThemeProviderso host applications can supply a customMudThememore directly. (07e94f5) (#754) - DataPanel rendering extensibility: Added
DataPanelItemFormat, customValueTemplate, reusable value component support, and dedicated renderers for timestamp/code/text values. (2b55e41) (#740) - Activity tabs: Extended
IActivityTabwith optional icon, icon color, visibility, and scroll-wrapping customization hooks, plus a reusableActivityTabimplementation. (2192884) (#723)
🔧 Improvements
- Workflow materializer UI: Improved workflow materializer handling and activity selection so workflows-as-activity instances load more reliably. (71f5dfa) (#731)
- Fallback designer UX: Added a warning alert when the fallback designer is active, helping users understand when no specific designer is registered for an activity type. (db66950) (#741)
- Fallback designer cleanup: Simplified fallback designer internals and root activity initialization. (e63a6ab)
- Query table initialization: Streamlined
QueryTableComponentBasequery state handling and initialization logic. (91868f2) - Activity properties panel: Made
ExpressionDescriptorProvidermutable inActivityPropertiesPaneland cleaned up formatting. (918dd8c)
🐛 Fixes
- Custom Elements host SignalR authentication: Registered
IHttpConnectionOptionsConfiguratorinElsa.Studio.Host.CustomElementssoWorkflowInstanceObserverFactoryresolves correctly when rendering custom-element viewers with API key or access-token attributes. (797449f) (#800) - OIDC configuration errors: Fixed OpenID Connect setup so missing service registrations and token-exchange failures surface as errors instead of causing repeated login loops. (a2941da) (#779)
- OIDC error hardening: Bounded diagnostic logging for token-exchange failures, reduced user-facing error detail, and preserved consumer-provided
IAuthenticationProviderManagerregistrations viaTryAddScoped. (9799d93) (#792) - Activity property syntax restore: Prevented activity property child content from rendering until
ExpressionDescriptorProvideris initialized, fixing syntax values such as JavaScript reverting to literal/default on reopen. (880525f) (#780)
🔒 Security
- OIDC failure handling: Avoids exposing raw token endpoint responses in the UI and bounds error payload handling while retaining diagnostic logging. (9799d93) (#792)
- Custom Elements authenticated SignalR: Bridges custom-element
api-key/access-tokencredentials into SignalRHttpConnectionOptions, allowing secured workflow viewers to connect without pulling in a full login module. (797449f) (#800)
🧩 Developer-facing changes
- Added
IAnonymousBackendApiClientProviderand default implementation for anonymous backend API access. (2192884) (#723) - Added
ISingleFlightCoordinatorand default scoped registration to coordinate concurrent operations. (2192884) (#723) - Added
IHttpConnectionOptionsConfiguratorin authentication abstractions for modules/hosts to customize SignalR connection authentication. (2192884) (#723) - Added authentication architecture documentation covering the new auth model. (2192884) (#723)
- Added contributor-focused pull request guidelines and a pull request template. (d40ba61) (5991d33) (c90cdf5)
🔁 CI / Build
- Updated package workflow base version to
3.7.0. (c5656de) - Updated
.NET 8.0and.NET 9.0package version entries and removed outdated entries. (18bfa1a) - Added release notes agent documentation and changelog output guidance. (f42cb0e) (ae16458)
📦 Dependencies
- Elsa.Api.Client: Updated to
3.7.0-preview.4451, with a later dependency bump commit included in the release range. (c4f9c11) (e1ba926) - MudBlazor:
8.15.0->9.0.0. (04b858a) (#760) - Radzen.Blazor:
8.3.5->9.0.5. (04b858a) (#760) - CodeBeam.MudBlazor.Extensions:
8.3.0->9.0.0-rc.1. (04b858a) (#760) - FluentValidation:
12.1.0->12.1.1. (04b858a) (#760) - Microsoft.SourceLink.GitHub:
8.0.0->10.0.103. (04b858a) (#760) - Wrappers npm dependencies: Updated
js-yaml,brace-expansion,glob,lodash,picomatch,yaml,storybook,vite,handlebars, andtar. Notable major updates includelodash4.17.21->4.18.1,tar6.2.1->7.5.11, andvite6.3.5->6.4.2. (aa2584b) (#790) - Wrappers npm dependencies: Updated
follow-redirects1.15.11->1.16.0andaxios1.12.0->1.15.0. (50d09a4) (#794)
📦 Full changelog (short)
- Refactor Authentication Framework and implement OpenID Connect. (2192884) (#723)
- Enhances Elsa Studio with workflow materializer UI updates. (71f5dfa) (#731)
- Add legacy Elsa Login authentication support and update related configurations and project references. (8612d5b)
- Introduce
ElsaIdentityUIFeature, update service registrations, and replace legacy authentication references withElsaIdentity. (7ffc15a) - Add pending filter for instances. (9af41ae) (#737)
- Displays incident count on workflow instance details. (b3ca85f) (#739)
- Add warning alert for fallback mechanism in designer. (db66950) (#741)
- Enhances DataPanel with flexible rendering options. (2b55e41) (#740)
- Simplify Fallback Designer by removing unused imports and redundant components. (e63a6ab)
- Refactor
QueryTableComponentBase: streamline query state handling and improve initialization logic. (91868f2) - Create Release Notes Agent for Elsa packages. (f42cb0e)
- Update base version to
3.7.0in GitHub Actions workflow configuration. (c5656de) - Simplify custom theme instalment. (07e94f5) (#754)
- Add and revise contributing guidelines and PR template. (d40ba61) (5991d33) (c90cdf5)
- Update package versions for .NET 8.0 and 9.0, and remove outdated entries. (18bfa1a)
- Update Elsa.Api.Client package version to
3.7.0-preview.4451. (c4f9c11) - Adds activity call stack visualization. (691d373) (#750)
- Document output location for release notes. (ae16458)
- Weblate translation updates across Arabic, Azerbaijani, Catalan, Czech, Dutch, German, Italian, Persian, Polish, Portuguese, Russian, Spanish, Swedish, Turkish, Ukrainian, Vietnamese, and Chinese locales. (992b45d) (39521ca)
- Update
ShowMessageBoxtoShowMessageBoxAsyncand upgrade package versions. (04b858a) (#760) - Fix/OIDC error handling. (a2941da) (#779)
- Prevent rendering of the child element until the
ExpressionDescriptorProvideris fully initialized. (880525f) (#780) - Bump the npm_and_yarn group across 1 directory with 10 updates. (aa2584b) (#790)
- Fix Copilot review comments from PR #779. (9799d93) (#792)
- Merge release/3.6.1 into the release branch. (b91dabe)
- chore(deps): bump Elsa.Api.Client. (e1ba926)
- Bump the npm_and_yarn group across 1 directory with 2 updates. (50d09a4) (#794)
- Make
ExpressionDescriptorProvidermutable inActivityPropertiesPanel.razor.csand fix formatting. (918dd8c) - fix: register
IHttpConnectionOptionsConfiguratorin Host.CustomElements. (797449f) (#800)