Add polyglot exports for Aspire.Hosting.DevTunnels by sebastienros · Pull Request #14905 · microsoft/aspire

sebastienros · 2026-03-03T19:04:47Z

Related to #14069

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions · 2026-03-03T19:04:59Z

🚀 Dogfood this PR with:

⚠️ WARNING: Do not do this without first carefully reviewing the code of this PR to satisfy yourself it is safe.

curl -fsSL https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.sh | bash -s -- 14905

Or

Run remotely in PowerShell:

iex "& { $(irm https://raw.githubusercontent.com/dotnet/aspire/main/eng/scripts/get-aspire-cli-pr.ps1) } 14905"

Copilot

Pull request overview

Adds polyglot (TypeScript/Node.js) exports and a validation AppHost for Aspire.Hosting.DevTunnels, enabling generated SDK bindings to invoke DevTunnels capabilities via AspireExport.

Changes:

Added [AspireExport] attributes to DevTunnels extension methods (AddDevTunnel, WithReference overloads, WithAnonymousAccess, GetEndpoint overloads).
Added a TypeScript validation AppHost (tsconfig/package/apphost/run profile and .aspire settings).
Added generated TypeScript “.modules” runtime + SDK (transport/base + large generated aspire.ts) and a codegen hash.

Reviewed changes

Copilot reviewed 9 out of 11 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
src/Aspire.Hosting.DevTunnels/DevTunnelResourceBuilderExtensions.cs	Exposes DevTunnels APIs via `AspireExport` for polyglot hosts.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/tsconfig.json	TS compiler configuration for the validation host.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/package.json	Node/TS dependencies and scripts to run/build the host.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/apphost.ts	Minimal TypeScript AppHost entry point.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/apphost.run.json	Local run profile + Aspire endpoints via env vars.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/transport.ts	JSON-RPC transport layer used by generated SDK.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/base.ts	Core TS helper types (builders, lists/dicts, ref expressions).
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/aspire.ts	Generated capability-based Aspire SDK incl. DevTunnels exports.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/.codegen-hash	Pins the generated module set to a generator hash.
playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.aspire/settings.json	Configures Aspire polyglot tooling for this validation host.

Files not reviewed (1)

playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/package-lock.json: Language not supported

playground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/base.ts

...ground/polyglot/TypeScript/Aspire.Hosting.DevTunnels/ValidationAppHost/.modules/transport.ts

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions · 2026-03-03T21:23:56Z

🎬 CLI E2E Test Recordings

The following terminal recordings are available for commit ea080d3:

Test	Recording
AddPackageInteractiveWhileAppHostRunningDetached	▶️ View Recording
AddPackageWhileAppHostRunningDetached	▶️ View Recording
AgentCommands_AllHelpOutputs_AreCorrect	▶️ View Recording
AgentInitCommand_MigratesDeprecatedConfig	▶️ View Recording
AgentInitCommand_WithMalformedMcpJson_ShowsErrorAndExitsNonZero	▶️ View Recording
AspireUpdateRemovesAppHostPackageVersionFromDirectoryPackagesProps	▶️ View Recording
Banner_DisplayedOnFirstRun	▶️ View Recording
Banner_DisplayedWithExplicitFlag	▶️ View Recording
CreateAndDeployToDockerCompose	▶️ View Recording
CreateAndDeployToDockerComposeInteractive	▶️ View Recording
CreateAndPublishToKubernetes	▶️ View Recording
CreateAndRunAspireStarterProject	▶️ View Recording
CreateAndRunAspireStarterProjectWithBundle	▶️ View Recording
CreateAndRunJsReactProject	▶️ View Recording
CreateAndRunPythonReactProject	▶️ View Recording
CreateAndRunTypeScriptStarterProject	▶️ View Recording
CreateEmptyAppHostProject	▶️ View Recording
CreateStartAndStopAspireProject	▶️ View Recording
CreateStartWaitAndStopAspireProject	▶️ View Recording
CreateTypeScriptAppHostWithViteApp	▶️ View Recording
DescribeCommandResolvesReplicaNames	▶️ View Recording
DescribeCommandShowsRunningResources	▶️ View Recording
DetachFormatJsonProducesValidJson	▶️ View Recording
DoctorCommand_DetectsDeprecatedAgentConfig	▶️ View Recording
DoctorCommand_WithSslCertDir_ShowsTrusted	▶️ View Recording
DoctorCommand_WithoutSslCertDir_ShowsPartiallyTrusted	▶️ View Recording
LogsCommandShowsResourceLogs	▶️ View Recording
PsCommandListsRunningAppHost	▶️ View Recording
PsFormatJsonOutputsOnlyJsonToStdout	▶️ View Recording
SecretCrudOnDotNetAppHost	▶️ View Recording
SecretCrudOnTypeScriptAppHost	▶️ View Recording
StagingChannel_ConfigureAndVerifySettings_ThenSwitchChannels	▶️ View Recording
StopAllAppHostsFromAppHostDirectory	▶️ View Recording
StopAllAppHostsFromUnrelatedDirectory	▶️ View Recording
StopNonInteractiveMultipleAppHostsShowsError	▶️ View Recording
StopNonInteractiveSingleAppHost	▶️ View Recording
StopWithNoRunningAppHostExitsSuccessfully	▶️ View Recording

_{📹 Recordings uploaded automatically from CI run #22648755644}

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

davidfowl · 2026-03-03T23:53:22Z

src/Aspire.Hosting.DevTunnels/DevTunnelResourceBuilderExtensions.cs

    /// <param name="targetEndpoint">The endpoint to expose via the dev tunnel.</param>
    /// <param name="allowAnonymous">Whether anonymous access is allowed.</param>
    /// <returns>The resource builder.</returns>
+    [AspireExport("withReference2", MethodName = "withReference", Description = "Configures the dev tunnel to expose a target endpoint.")]


Don't call it this.

Add [AspireExport] or [AspireExportIgnore] attributes to all 11 public extension methods in DevTunnelResourceBuilderExtensions.cs. Exported methods (6): - addDevTunnel: Create dev tunnel resource - withTunnelReference: Expose specific endpoint via tunnel - withTunnelReferenceAnonymous: Expose endpoint with access control - withTunnelReferenceAll: Expose all endpoints on a resource - withAnonymousAccess: Make tunnel anonymously accessible - getTunnelEndpoint: Get public tunnel endpoint for a given endpoint Ignored methods (5) with reasons: - WithReference(DevTunnelPortOptions): Not ATS-compatible - WithReference(EndpointReference, DevTunnelPortOptions): Not ATS-compatible - GetEndpoint<TResource>: Delegates to IResource overload - GetEndpoint(IResource, string): IResource not ATS-mapped - WithReference(targetResource, tunnelResource): Service discovery injection Update TypeScript validation apphost to exercise all exported methods and regenerate SDK. TypeScript compilation (tsc --noEmit) passes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Add polyglot exports for Aspire.Hosting.DevTunnels Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Refine AspireExport descriptions for polyglot-devtunnels Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Use generated methods in devtunnels apphost Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> * Complete AspireExport coverage for Aspire.Hosting.DevTunnels Add [AspireExport] or [AspireExportIgnore] attributes to all 11 public extension methods in DevTunnelResourceBuilderExtensions.cs. Exported methods (6): - addDevTunnel: Create dev tunnel resource - withTunnelReference: Expose specific endpoint via tunnel - withTunnelReferenceAnonymous: Expose endpoint with access control - withTunnelReferenceAll: Expose all endpoints on a resource - withAnonymousAccess: Make tunnel anonymously accessible - getTunnelEndpoint: Get public tunnel endpoint for a given endpoint Ignored methods (5) with reasons: - WithReference(DevTunnelPortOptions): Not ATS-compatible - WithReference(EndpointReference, DevTunnelPortOptions): Not ATS-compatible - GetEndpoint<TResource>: Delegates to IResource overload - GetEndpoint(IResource, string): IResource not ATS-mapped - WithReference(targetResource, tunnelResource): Service discovery injection Update TypeScript validation apphost to exercise all exported methods and regenerate SDK. TypeScript compilation (tsc --noEmit) passes. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com> --------- Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add polyglot exports for Aspire.Hosting.DevTunnels

9401f2b

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Copilot AI review requested due to automatic review settings March 3, 2026 19:05

Copilot AI reviewed Mar 3, 2026

View reviewed changes

sebastienros mentioned this pull request Mar 3, 2026

Epic: TypeScript AppHost - Complete Integration Support #14069

Closed

76 tasks

Copilot started reviewing on behalf of sebastienros March 3, 2026 19:12 View session

Refine AspireExport descriptions for polyglot-devtunnels

e58a711

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

github-actions bot mentioned this pull request Mar 3, 2026

[pull requests] Review required #13834

Open

Use generated methods in devtunnels apphost

f359d26

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

davidfowl reviewed Mar 3, 2026

View reviewed changes

sebastienros requested a review from davidfowl March 4, 2026 00:11

davidfowl approved these changes Mar 4, 2026

View reviewed changes

sebastienros enabled auto-merge (squash) March 4, 2026 00:14

sebastienros merged commit ac9fc75 into release/13.2 Mar 4, 2026
758 of 761 checks passed

sebastienros deleted the sebros/polyglot-devtunnels branch March 4, 2026 00:53

dotnet-policy-service bot added this to the 13.2 milestone Mar 4, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add polyglot exports for Aspire.Hosting.DevTunnels#14905

Add polyglot exports for Aspire.Hosting.DevTunnels#14905
sebastienros merged 4 commits intorelease/13.2from
sebros/polyglot-devtunnels

sebastienros commented Mar 3, 2026

Uh oh!

github-actions bot commented Mar 3, 2026 •

edited

Loading

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 3, 2026 •

edited

Loading

Uh oh!

davidfowl Mar 3, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

sebastienros commented Mar 3, 2026

Uh oh!

github-actions bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Uh oh!

Uh oh!

github-actions bot commented Mar 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🎬 CLI E2E Test Recordings

Uh oh!

davidfowl Mar 3, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

github-actions bot commented Mar 3, 2026 •

edited

Loading

github-actions bot commented Mar 3, 2026 •

edited

Loading