Description

Replaces DeferredValueProvider with ConditionalReferenceExpression, a new type that models conditional values in connection strings and other reference expressions. This enables proper manifest publishing and polyglot code generation for conditional logic like TLS ssl=true in Redis connection strings.

ConditionalReferenceExpression

A ternary-style expression type that evaluates a boolean IValueProvider condition and selects between two ReferenceExpression branches (whenTrue/whenFalse). Key design decisions:

• Auto-generated names: The manifest entry name is derived from the condition's ValueExpression at construction time (e.g., {redis.bindings.tcp.tlsEnabled} → cond-redis-bindings-tcp-tlsenabled), eliminating the need for explicit naming
• Manifest integration: Written as value.v0 entries in the manifest, referenced via {name.value} in connection strings
• Create() factory: Follows the same pattern as ReferenceExpression.Create

Polyglot ATS Support

All 5 polyglot language base files (TypeScript, Go, Python, Java, Rust) support:

• create() factory method for client-side CRE construction
• toJSON() serialization using $condExpr format: { "$condExpr": { "condition": <handle>, "whenTrue": <$expr>, "whenFalse": <$expr> } }
• Server-side $condExpr unmarshalling via ConditionalReferenceExpressionRef in AtsMarshaller

Redis TLS

Re-enables TLS by default for Redis container endpoints. EndpointReference.GetTlsValue now returns a ConditionalReferenceExpression instead of using a closure-based DeferredValueProvider, making it compatible with polyglot code generation.

Fixes #13645

Changes

New files

• src/Aspire.Hosting/ApplicationModel/ConditionalReferenceExpression.cs — Core type with Create(), auto-name generation, manifest support
• src/Aspire.Hosting.RemoteHost/Ats/ConditionalReferenceExpressionRef.cs — Server-side $condExpr JSON unmarshalling
• tests/Aspire.Hosting.Tests/ConditionalReferenceExpressionTests.cs — 10 unit tests

Modified files

• EndpointReference.cs — GetTlsValue returns CRE instead of DeferredValueProvider
• RedisResource.cs — Updated BuildConnectionString to use new GetTlsValue signature
• ManifestPublishingContext.cs — Registers and writes CRE entries as value.v0 resources
• 5 polyglot base files — create()/toJSON() for ConditionalReferenceExpression
• 5 code generators — Skip logic for ConditionalReferenceExpression type
• Redis tests — Pattern matching assertions for auto-generated CRE names + manifest entry verification
• Marshaller tests — 4 $condExpr unmarshalling tests
• Handle registry tests — CRE handle registration test

Removed files

• DeferredValueProvider.cs — Replaced by ConditionalReferenceExpression
• DeferredValueProviderTests.cs — Replaced by ConditionalReferenceExpressionTests

Checklist

• Is this feature complete?
  • Yes. Ready to ship.
  • No. Follow-up changes expected.
• Are you including unit tests for the changes and scenario tests if relevant?
  • Yes
  • No
• Did you add public API?
  • Yes
    • If yes, did you have an API Review for it?
      • Yes
      • No
    • Did you add <remarks /> and <code /> elements on your triple slash comments?
      • Yes
      • No
  • No
• Does the change make any security assumptions or guarantees?
  • Yes
  • No
• Does the change require an update in our Aspire docs?
  • Yes
    • Link to aspire.dev issue:
      • New issue
  • No