Added note about project being archived

[auto-updated: dependencies]

.appveyor.yml

@@ -1,21 +1,19 @@
 init:
-  - git config --global core.autocrlf true
+- git config --global core.autocrlf true
 install:
-  - ps: Install-Product node 6.9.2 x64
+- ps: Install-Product node 6.9.2 x64
 branches:
   only:
   - master
-    - release
-    - dev
+  - /^release\/.*$/
   - /^(.*\/)?ci-.*$/
-    - /^rel\/.*/
 build_script:
-  - ps: .\run.ps1 default-build
+- ps: .\run.ps1 default-build
 clone_depth: 1
 environment:
   global:
     DOTNET_SKIP_FIRST_TIME_EXPERIENCE: true
     DOTNET_CLI_TELEMETRY_OPTOUT: 1
-test: off
-deploy: off
+test: 'off'
+deploy: 'off'
 os: Visual Studio 2017

.travis.yml

@@ -12,8 +12,13 @@ addons:
     - zlib1g
 mono: none
 os:
-  - linux
-  - osx
+- linux
+- osx
 osx_image: xcode7.1
 script:
-  - ./build.sh
+- ./build.sh
+branches:
+  only:
+  - master
+  - /^release\/.*$/
+  - /^(.*\/)?ci-.*$/

.vsts-pipelines/builds/ci-internal.yml

@@ -0,0 +1,13 @@
+trigger:
+- master
+- release/*
+
+resources:
+  repositories:
+  - repository: buildtools
+    type: git
+    name: aspnet-BuildTools
+    ref: refs/heads/master
+
+phases:
+- template: .vsts-pipelines/templates/project-ci.yml@buildtools

.vsts-pipelines/builds/ci-public.yml

@@ -0,0 +1,15 @@
+trigger:
+- master
+- release/*
+
+# See https://github.com/aspnet/BuildTools
+resources:
+  repositories:
+  - repository: buildtools
+    type: github
+    endpoint: DotNet-Bot GitHub Connection
+    name: aspnet/BuildTools
+    ref: refs/heads/master
+
+phases:
+- template: .vsts-pipelines/templates/project-ci.yml@buildtools

CONTRIBUTING.md

@@ -1,4 +1,4 @@
 Contributing
 ======
 
-Information on contributing to this repo is in the [Contributing Guide](https://github.com/aspnet/Home/blob/dev/CONTRIBUTING.md) in the Home repo.
+Information on contributing to this repo is in the [Contributing Guide](https://github.com/aspnet/Home/blob/master/CONTRIBUTING.md) in the Home repo.

Directory.Build.props

@@ -1,6 +1,7 @@
 <Project>
   <Import Project="version.props" />
   <Import Project="build\dependencies.props" />
+  <Import Project="build\sources.props" />
 
   <PropertyGroup>
     <Product>Microsoft ASP.NET Core</Product>
@@ -9,7 +10,6 @@
     <RepositoryRoot>$(MSBuildThisFileDirectory)</RepositoryRoot>
     <AssemblyOriginatorKeyFile>$(MSBuildThisFileDirectory)build\Key.snk</AssemblyOriginatorKeyFile>
     <SignAssembly>true</SignAssembly>
-    <PublicSign Condition="'$(OS)' != 'Windows_NT'">true</PublicSign>
     <TreatWarningsAsErrors>true</TreatWarningsAsErrors>
   </PropertyGroup>
 </Project>

Directory.Build.targets

@@ -1,5 +1,6 @@
-<Project>
+<Project>
   <PropertyGroup>
-    <RuntimeFrameworkVersion Condition=" '$(TargetFramework)' == 'netcoreapp2.0' ">$(MicrosoftNETCoreApp20PackageVersion)</RuntimeFrameworkVersion>
+    <RuntimeFrameworkVersion Condition=" '$(TargetFramework)' == 'netcoreapp3.0' ">$(MicrosoftNETCoreAppPackageVersion)</RuntimeFrameworkVersion>
+    <NETStandardImplicitPackageVersion Condition=" '$(TargetFramework)' == 'netstandard2.0' ">$(NETStandardLibrary20PackageVersion)</NETStandardImplicitPackageVersion>
   </PropertyGroup>
 </Project>

JavaScriptServices.sln

@@ -1,13 +1,19 @@
 
 Microsoft Visual Studio Solution File, Format Version 12.00
 # Visual Studio 15
-VisualStudioVersion = 15.0.27019.1
+VisualStudioVersion = 15.0.26730.16
 MinimumVisualStudioVersion = 15.0.26730.03
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "src", "src", "{27304DDE-AFB2-4F8B-B765-E3E2F11E886C}"
 	ProjectSection(SolutionItems) = preProject
 		src\Directory.Build.props = src\Directory.Build.props
 	EndProjectSection
 EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.NodeServices", "src\Microsoft.AspNetCore.NodeServices\Microsoft.AspNetCore.NodeServices.csproj", "{66B77203-1469-41DF-92F2-2BE6900BD36F}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.NodeServices.Sockets", "src\Microsoft.AspNetCore.NodeServices.Sockets\Microsoft.AspNetCore.NodeServices.Sockets.csproj", "{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Microsoft.AspNetCore.SpaServices", "src\Microsoft.AspNetCore.SpaServices\Microsoft.AspNetCore.SpaServices.csproj", "{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC}"
+EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "misc", "misc", "{99EAF1FE-22C8-4526-BE78-74B24125D37F}"
 	ProjectSection(SolutionItems) = preProject
 		.gitignore = .gitignore
@@ -15,6 +21,16 @@ Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "misc", "misc", "{99EAF1FE-2
 		README.md = README.md
 	EndProjectSection
 EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "samples", "samples", "{23836492-E7F4-4376-85BF-A635C304AC46}"
+EndProject
+Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "misc", "misc", "{E6A161EA-646C-4033-9090-95BE809AB8D9}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "LatencyTest", "samples\misc\LatencyTest\LatencyTest.csproj", "{1931B19A-EC42-4D56-B2D0-FB06D17244DA}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "Webpack", "samples\misc\Webpack\Webpack.csproj", "{DE479DC3-1461-4EAD-A188-4AF7AA4AE344}"
+EndProject
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "NodeServicesExamples", "samples\misc\NodeServicesExamples\NodeServicesExamples.csproj", "{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}"
+EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{645F7363-1240-4FB6-9422-B32A327C979F}"
 	ProjectSection(SolutionItems) = preProject
 		Directory.Build.props = Directory.Build.props
@@ -29,6 +45,30 @@ Global
 		Release|Any CPU = Release|Any CPU
 	EndGlobalSection
 	GlobalSection(ProjectConfigurationPlatforms) = postSolution
+		{66B77203-1469-41DF-92F2-2BE6900BD36F}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{66B77203-1469-41DF-92F2-2BE6900BD36F}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{66B77203-1469-41DF-92F2-2BE6900BD36F}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{66B77203-1469-41DF-92F2-2BE6900BD36F}.Release|Any CPU.Build.0 = Release|Any CPU
+		{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3}.Release|Any CPU.Build.0 = Release|Any CPU
+		{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC}.Release|Any CPU.Build.0 = Release|Any CPU
+		{1931B19A-EC42-4D56-B2D0-FB06D17244DA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{1931B19A-EC42-4D56-B2D0-FB06D17244DA}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{1931B19A-EC42-4D56-B2D0-FB06D17244DA}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{1931B19A-EC42-4D56-B2D0-FB06D17244DA}.Release|Any CPU.Build.0 = Release|Any CPU
+		{DE479DC3-1461-4EAD-A188-4AF7AA4AE344}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{DE479DC3-1461-4EAD-A188-4AF7AA4AE344}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{DE479DC3-1461-4EAD-A188-4AF7AA4AE344}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{DE479DC3-1461-4EAD-A188-4AF7AA4AE344}.Release|Any CPU.Build.0 = Release|Any CPU
+		{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
+		{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Debug|Any CPU.Build.0 = Debug|Any CPU
+		{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.ActiveCfg = Release|Any CPU
+		{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE}.Release|Any CPU.Build.0 = Release|Any CPU
 		{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
 		{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Debug|Any CPU.Build.0 = Debug|Any CPU
 		{D40BD1C4-6A6F-4213-8535-1057F3EB3400}.Release|Any CPU.ActiveCfg = Release|Any CPU
@@ -38,6 +78,13 @@ Global
 		HideSolutionNode = FALSE
 	EndGlobalSection
 	GlobalSection(NestedProjects) = preSolution
+		{66B77203-1469-41DF-92F2-2BE6900BD36F} = {27304DDE-AFB2-4F8B-B765-E3E2F11E886C}
+		{F46DEF99-6FAA-4406-B5D8-6FF34EF669E3} = {27304DDE-AFB2-4F8B-B765-E3E2F11E886C}
+		{66B071A8-EFC8-4A06-BEF6-06B99AE27EEC} = {27304DDE-AFB2-4F8B-B765-E3E2F11E886C}
+		{E6A161EA-646C-4033-9090-95BE809AB8D9} = {23836492-E7F4-4376-85BF-A635C304AC46}
+		{1931B19A-EC42-4D56-B2D0-FB06D17244DA} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
+		{DE479DC3-1461-4EAD-A188-4AF7AA4AE344} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
+		{93EFCC5F-C6EE-4623-894F-A42B22C0B6FE} = {E6A161EA-646C-4033-9090-95BE809AB8D9}
 		{D40BD1C4-6A6F-4213-8535-1057F3EB3400} = {27304DDE-AFB2-4F8B-B765-E3E2F11E886C}
 	EndGlobalSection
 	GlobalSection(ExtensibilityGlobals) = postSolution

LICENSE.txt

@@ -1,14 +1,201 @@
-Copyright (c) .NET Foundation and Contributors
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
 
-All rights reserved.
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
 
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright (c) .NET Foundation and Contributors
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
 
        http://www.apache.org/licenses/LICENSE-2.0
 
-Unless required by applicable law or agreed to in writing, software distributed
-under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
-CONDITIONS OF ANY KIND, either express or implied. See the License for the
-specific language governing permissions and limitations under the License.
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

NuGet.config

@@ -2,8 +2,6 @@
 <configuration>
   <packageSources>
     <clear />
-    <add key="AspNetCore" value="https://dotnet.myget.org/F/aspnetcore-ci-dev/api/v3/index.json" />
-    <add key="AspNetCoreTools" value="https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json" />
-    <add key="NuGet" value="https://api.nuget.org/v3/index.json" />
+    <!-- Restore sources should be defined in build/sources.props. -->
   </packageSources>
 </configuration>

NuGetPackageVerifier.json

@@ -0,0 +1,7 @@
+{
+  "Default": {
+    "rules": [
+      "DefaultCompositeRule"
+    ]
+  }
+}

README.md

@@ -1 +1,91 @@
-This branch exists only to build `Microsoft.AspNetCore.SpaServices.Extensions` for an OOB release. It does not contain sources for any other packages or samples.
+# JavaScriptServices [Archived]
+
+## IMPORTANT
+
+The features described in this article are obsolete as of ASP.NET Core 3.0. A simpler SPA frameworks integration mechanism is available in the [Microsoft.AspNetCore.SpaServices.Extensions](https://www.nuget.org/packages/Microsoft.AspNetCore.SpaServices.Extensions) NuGet package. For more information, see [[Announcement] Obsoleting Microsoft.AspNetCore.SpaServices and Microsoft.AspNetCore.NodeServices](https://github.com/dotnet/AspNetCore/issues/12890).
+
+
+## What is this?
+
+`JavaScriptServices` is a set of client-side technologies for ASP.NET Core. It provides infrastructure that you'll find useful if you:
+
+-  Use Angular / React / Vue / Aurelia / Knockout / etc.
+-  Build your client-side resources using Webpack.
+-  Execute JavaScript on the server at runtime.
+
+Read [Building Single Page Applications on ASP.NET Core with JavaScriptServices](https://blogs.msdn.microsoft.com/webdev/2017/02/14/building-single-page-applications-on-asp-net-core-with-javascriptservices/) for more details.
+
+This repo contains:
+
+ * A set of NuGet/NPM packages that implement functionality for:
+   * Invoking arbitrary NPM packages at runtime from .NET code ([docs](/src/Microsoft.AspNetCore.NodeServices#simple-usage-example))
+   * Server-side prerendering of SPA components ([docs](/src/Microsoft.AspNetCore.SpaServices#server-side-prerendering))
+   * Webpack dev middleware ([docs](/src/Microsoft.AspNetCore.SpaServices#webpack-dev-middleware))
+   * Hot module replacement (HMR) ([docs](/src/Microsoft.AspNetCore.SpaServices#webpack-hot-module-replacement))
+   * Server-side and client-side routing integration ([docs](/src/Microsoft.AspNetCore.SpaServices#routing-helper-mapspafallbackroute))
+   * Server-side and client-side validation integration
+   * "Lazy loading" for Knockout apps
+ * Samples and docs
+
+It's cross-platform (Windows, Linux, or macOS) and works with .NET Core 2.0 or later.
+
+## Creating new applications
+
+Prerequisites:
+
+* [.NET Core 2.0](https://www.microsoft.com/net/core) (or later) SDK
+* [Node.js](https://nodejs.org/) version 6 (or later)
+
+With these prerequisites, you can immediately create new ASP.NET Core applications that use Angular, React, or React+Redux without having to install anything extra.
+
+### Option 1: Creating Angular/React/Redux applications from the command line (cross-platform)
+
+In an empty directory, run (for example) `dotnet new angular`. Other supported SPA frameworks include React and React+Redux. You can see the list of available SPA templates by running `dotnet new spa`.
+
+Once the generator has run and restored all the dependencies, you can start up your new ASP.NET Core SPA:
+
+    npm install
+    dotnet run
+
+### Option 2: Creating Angular/React/Redux applications using Visual Studio 2017 Update 3 or later (Windows only)
+
+Using the `File`->`New Project` dialog, select *ASP.NET Core Web Application*. You will then be offered the option to create an application with Angular, React, or React+Redux. When the application is created, you can build and run it in the normal way.
+
+### More info and other SPA frameworks
+
+For a more detailed (albeit somewhat outdated) walkthrough, see [getting started with the `aspnetcore-spa` generator](http://blog.stevensanderson.com/2016/05/02/angular2-react-knockout-apps-on-aspnet-core/).
+
+If you want to build an ASP.NET Core application with Aurelia, Knockout, or Vue, you can use the `Microsoft.AspNetCore.SpaTemplates` package. On the command line, run `dotnet new --install Microsoft.AspNetCore.SpaTemplates`. Then you will be able to run `dotnet new aurelia` (or `dotnet new vue`, etc.) to create your new application.
+
+## Adding to existing applications
+
+If you have an existing ASP.NET Core application, or if you just want to use the underlying JavaScriptServices packages directly, you can install these packages using NuGet and NPM:
+
+ * `Microsoft.AspNetCore.NodeServices`
+   * This provides a fast and robust way for .NET code to run JavaScript on the server inside a Node.js environment. You can use this to consume arbitrary functionality from NPM packages at runtime in your ASP.NET Core app.
+   * Most applications developers don't need to use this directly, but you can do so if you want to implement your own functionality that involves calling Node.js code from .NET at runtime.
+   * Find [documentation and usage examples here](/src/Microsoft.AspNetCore.NodeServices#microsoftaspnetcorenodeservices).
+ * `Microsoft.AspNetCore.SpaServices`
+   * This provides infrastructure that's generally useful when building Single Page Applications (SPAs) with technologies such as Angular or React (for example, server-side prerendering and webpack middleware). Internally, it uses the `NodeServices` package to implement its features.
+   * Find [documentation and usage examples here](/src/Microsoft.AspNetCore.SpaServices#microsoftaspnetcorespaservices)
+
+There were previously other packages called  `Microsoft.AspNetCore.AngularServices` and `Microsoft.AspNetCore.ReactServices` but these are not currently needed - all applicable functionality is in `Microsoft.AspNetCore.SpaServices`, because it's sufficiently general.
+
+If you want to build a helper library for some other SPA framework, you can do so by taking a dependency on `Microsoft.AspNetCore.SpaServices` and wrapping its functionality in whatever way is most useful for your SPA framework.
+
+## Samples
+
+The [`samples` directory](/samples) contains examples of:
+
+- Using the JavaScript services family of packages with Angular and React.
+- A standalone `NodeServices` usage for runtime code transpilation and image processing.
+
+**To run the samples:**
+
+ * Clone this repo
+ * At the repo's root directory (the one containing `src`, `samples`, etc.), run `dotnet restore`
+ * Change directory to the sample you want to run (for example, `cd samples/angular/MusicStore`)
+ * Restore Node dependencies by running `npm install`
+   * If you're trying to run the Angular "Music Store" sample, then also run `gulp` (which you need to have installed globally). None of the other samples require this.
+ * Run the application (`dotnet run`)
+ * Browse to [http://localhost:5000](http://localhost:5000)

build/Push.targets

@@ -1,15 +0,0 @@
-<Project>
-  <Target Name="Push" DependsOnTargets="_PushNuGet" />
-
-  <ItemGroup>
-    <PackagesToPush Include="$(BuildDir)*.nupkg" />
-  </ItemGroup>
-
-  <Target Name="_PushNuGet" Condition="@(PackagesToPush->Count()) != 0">
-    <Error Text="Missing required property: NuGetPublishFeed"  Condition=" '$(NuGetPublishFeed)' == '' "/>
-    <PushNuGetPackages
-      Packages="@(PackagesToPush)"
-      Feed="$(NuGetPublishFeed)"
-      ApiKey="$(APIKey)" />
-  </Target>
-</Project>

build/dependencies.props

@@ -1,27 +1,30 @@
-<Project>
+<Project>
   <PropertyGroup>
     <MSBuildAllProjects>$(MSBuildAllProjects);$(MSBuildThisFileFullPath)</MSBuildAllProjects>
   </PropertyGroup>
   <PropertyGroup Label="Package Versions">
-    <InternalAspNetCoreSdkPackageVersion>2.1.0-preview1-15549</InternalAspNetCoreSdkPackageVersion>
-    <MicrosoftAspNetCoreDiagnosticsPackageVersion>2.0.1</MicrosoftAspNetCoreDiagnosticsPackageVersion>
-    <MicrosoftAspNetCoreHostingAbstractionsPackageVersion>2.0.1</MicrosoftAspNetCoreHostingAbstractionsPackageVersion>
-    <MicrosoftAspNetCoreHostingPackageVersion>2.0.1</MicrosoftAspNetCoreHostingPackageVersion>
-    <MicrosoftAspNetCoreMvcPackageVersion>2.0.1</MicrosoftAspNetCoreMvcPackageVersion>
-    <MicrosoftAspNetCoreMvcTagHelpersPackageVersion>2.0.1</MicrosoftAspNetCoreMvcTagHelpersPackageVersion>
-    <MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>2.0.1</MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>
-    <MicrosoftAspNetCoreServerIISIntegrationPackageVersion>2.0.1</MicrosoftAspNetCoreServerIISIntegrationPackageVersion>
-    <MicrosoftAspNetCoreServerKestrelPackageVersion>2.0.1</MicrosoftAspNetCoreServerKestrelPackageVersion>
-    <MicrosoftAspNetCoreSpaServicesPackageVersion>2.0.1</MicrosoftAspNetCoreSpaServicesPackageVersion>
-    <MicrosoftAspNetCoreStaticFilesPackageVersion>2.0.1</MicrosoftAspNetCoreStaticFilesPackageVersion>
-    <MicrosoftAspNetCoreWebSocketsPackageVersion>2.0.1</MicrosoftAspNetCoreWebSocketsPackageVersion>
-    <MicrosoftExtensionsDependencyInjectionPackageVersion>2.0.0</MicrosoftExtensionsDependencyInjectionPackageVersion>
-    <MicrosoftExtensionsFileProvidersPhysicalPackageVersion>2.0.0</MicrosoftExtensionsFileProvidersPhysicalPackageVersion>
-    <MicrosoftExtensionsLoggingConsolePackageVersion>2.0.0</MicrosoftExtensionsLoggingConsolePackageVersion>
-    <MicrosoftExtensionsLoggingDebugPackageVersion>2.0.0</MicrosoftExtensionsLoggingDebugPackageVersion>
-    <MicrosoftNETCoreApp20PackageVersion>2.0.0</MicrosoftNETCoreApp20PackageVersion>
-    <NewtonsoftJsonPackageVersion>10.0.1</NewtonsoftJsonPackageVersion>
-    <SystemThreadingTasksDataflowPackageVersion>4.8.0</SystemThreadingTasksDataflowPackageVersion>
+    <InternalAspNetCoreSdkPackageVersion>3.0.0-build-20181114.5</InternalAspNetCoreSdkPackageVersion>
+    <MicrosoftAspNetCoreDiagnosticsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreDiagnosticsPackageVersion>
+    <MicrosoftAspNetCoreHostingAbstractionsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreHostingAbstractionsPackageVersion>
+    <MicrosoftAspNetCoreHostingPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreHostingPackageVersion>
+    <MicrosoftAspNetCoreMvcPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcPackageVersion>
+    <MicrosoftAspNetCoreMvcTagHelpersPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcTagHelpersPackageVersion>
+    <MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreMvcViewFeaturesPackageVersion>
+    <MicrosoftAspNetCoreServerIISIntegrationPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreServerIISIntegrationPackageVersion>
+    <MicrosoftAspNetCoreServerKestrelPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreServerKestrelPackageVersion>
+    <MicrosoftAspNetCoreStaticFilesPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreStaticFilesPackageVersion>
+    <MicrosoftAspNetCoreWebSocketsPackageVersion>3.0.0-alpha1-10742</MicrosoftAspNetCoreWebSocketsPackageVersion>
+    <MicrosoftExtensionsDependencyInjectionPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsDependencyInjectionPackageVersion>
+    <MicrosoftExtensionsFileProvidersPhysicalPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsFileProvidersPhysicalPackageVersion>
+    <MicrosoftExtensionsLoggingAbstractionsPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingAbstractionsPackageVersion>
+    <MicrosoftExtensionsLoggingConsolePackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingConsolePackageVersion>
+    <MicrosoftExtensionsLoggingDebugPackageVersion>3.0.0-preview-181113-11</MicrosoftExtensionsLoggingDebugPackageVersion>
+    <MicrosoftNETCoreAppPackageVersion>3.0.0-preview1-26907-05</MicrosoftNETCoreAppPackageVersion>
+    <MicrosoftNETSdkRazorPackageVersion>3.0.0-alpha1-10742</MicrosoftNETSdkRazorPackageVersion>
+    <NETStandardLibrary20PackageVersion>2.0.3</NETStandardLibrary20PackageVersion>
+    <NewtonsoftJsonPackageVersion>11.0.2</NewtonsoftJsonPackageVersion>
+    <SystemThreadingTasksDataflowPackageVersion>4.10.0-preview1-26907-04</SystemThreadingTasksDataflowPackageVersion>
   </PropertyGroup>
   <Import Project="$(DotNetPackageVersionPropsPath)" Condition=" '$(DotNetPackageVersionPropsPath)' != '' " />
+  <PropertyGroup Label="Package Versions: Pinned" />
 </Project>

build/repo.props

@@ -1,7 +1,13 @@
-<Project>
+<Project>
+  <Import Project="dependencies.props" />
+
   <PropertyGroup>
     <!-- These properties are use by the automation that updates dependencies.props -->
     <LineupPackageId>Internal.AspNetCore.Universe.Lineup</LineupPackageId>
-    <LineupPackageRestoreSource>https://dotnet.myget.org/F/aspnetcore-ci-dev/api/v3/index.json</LineupPackageRestoreSource>
+    <LineupPackageRestoreSource>https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json</LineupPackageRestoreSource>
   </PropertyGroup>
+
+  <ItemGroup>
+    <DotNetCoreRuntime Include="$(MicrosoftNETCoreAppPackageVersion)" />
+  </ItemGroup>
 </Project>

build/repo.targets

@@ -1,3 +0,0 @@
-<Project>
-  <Import Project="Push.targets" />
-</Project>

build/sources.props

@@ -0,0 +1,17 @@
+<Project>
+  <Import Project="$(DotNetRestoreSourcePropsPath)" Condition="'$(DotNetRestoreSourcePropsPath)' != ''"/>
+
+  <PropertyGroup Label="RestoreSources">
+    <RestoreSources>$(DotNetRestoreSources)</RestoreSources>
+    <RestoreSources Condition="'$(DotNetBuildOffline)' != 'true' AND '$(AspNetUniverseBuildOffline)' != 'true' ">
+      $(RestoreSources);
+      https://dotnet.myget.org/F/dotnet-core/api/v3/index.json;
+      https://dotnet.myget.org/F/aspnetcore-dev/api/v3/index.json;
+      https://dotnet.myget.org/F/aspnetcore-tools/api/v3/index.json;
+    </RestoreSources>
+    <RestoreSources Condition="'$(DotNetBuildOffline)' != 'true'">
+      $(RestoreSources);
+      https://api.nuget.org/v3/index.json;
+    </RestoreSources>
+  </PropertyGroup>
+</Project>

korebuild-lock.txt

@@ -1,2 +1,2 @@
-version:2.1.0-preview1-15549
-commithash:f570e08585fec510dd60cd4bfe8795388b757a95
+version:3.0.0-build-20181114.5
+commithash:880e9a204d4ee4a18dfd83c9fb05a192a28bca60

korebuild.json

@@ -1,6 +1,6 @@
 {
-  "$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/dev/tools/korebuild.schema.json",
-  "channel": "dev",
+  "$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/master/tools/korebuild.schema.json",
+  "channel": "master",
   "toolsets": {
     "nodejs": {
       "required": true,

run.ps1

@@ -26,9 +26,18 @@ The base url where build tools can be downloaded. Overrides the value from the c
 .PARAMETER Update
 Updates KoreBuild to the latest version even if a lock file is present.
 
+.PARAMETER Reinstall
+Re-installs KoreBuild
+
 .PARAMETER ConfigFile
 The path to the configuration file that stores values. Defaults to korebuild.json.
 
+.PARAMETER ToolsSourceSuffix
+The Suffix to append to the end of the ToolsSource. Useful for query strings in blob stores.
+
+.PARAMETER CI
+Sets up CI specific settings and variables.
+
 .PARAMETER Arguments
 Arguments to be passed to the command
 
@@ -43,15 +52,15 @@ in the file are overridden by command line parameters.
 Example config file:
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/dev/tools/korebuild.schema.json",
-  "channel": "dev",
+  "$schema": "https://raw.githubusercontent.com/aspnet/BuildTools/master/tools/korebuild.schema.json",
+  "channel": "master",
   "toolsSource": "https://aspnetcore.blob.core.windows.net/buildtools"
 }
 ```
 #>
 [CmdletBinding(PositionalBinding = $false)]
 param(
-    [Parameter(Mandatory=$true, Position = 0)]
+    [Parameter(Mandatory = $true, Position = 0)]
     [string]$Command,
     [string]$Path = $PSScriptRoot,
     [Alias('c')]
@@ -62,7 +71,10 @@ param(
     [string]$ToolsSource,
     [Alias('u')]
     [switch]$Update,
-    [string]$ConfigFile,
+    [switch]$Reinstall,
+    [string]$ToolsSourceSuffix,
+    [string]$ConfigFile = $null,
+    [switch]$CI,
     [Parameter(ValueFromRemainingArguments = $true)]
     [string[]]$Arguments
 )
@@ -79,7 +91,7 @@ function Get-KoreBuild {
     $lockFile = Join-Path $Path 'korebuild-lock.txt'
 
     if (!(Test-Path $lockFile) -or $Update) {
-        Get-RemoteFile "$ToolsSource/korebuild/channels/$Channel/latest.txt" $lockFile
+        Get-RemoteFile "$ToolsSource/korebuild/channels/$Channel/latest.txt" $lockFile $ToolsSourceSuffix
     }
 
     $version = Get-Content $lockFile | Where-Object { $_ -like 'version:*' } | Select-Object -first 1
@@ -89,6 +101,10 @@ function Get-KoreBuild {
     $version = $version.TrimStart('version:').Trim()
     $korebuildPath = Join-Paths $DotNetHome ('buildtools', 'korebuild', $version)
 
+    if ($Reinstall -and (Test-Path $korebuildPath)) {
+        Remove-Item -Force -Recurse $korebuildPath
+    }
+
     if (!(Test-Path $korebuildPath)) {
         Write-Host -ForegroundColor Magenta "Downloading KoreBuild $version"
         New-Item -ItemType Directory -Path $korebuildPath | Out-Null
@@ -96,10 +112,10 @@ function Get-KoreBuild {
 
         try {
             $tmpfile = Join-Path ([IO.Path]::GetTempPath()) "KoreBuild-$([guid]::NewGuid()).zip"
-            Get-RemoteFile $remotePath $tmpfile
-            if (Get-Command -Name 'Expand-Archive' -ErrorAction Ignore) {
+            Get-RemoteFile $remotePath $tmpfile $ToolsSourceSuffix
+            if (Get-Command -Name 'Microsoft.PowerShell.Archive\Expand-Archive' -ErrorAction Ignore) {
                 # Use built-in commands where possible as they are cross-plat compatible
-                Expand-Archive -Path $tmpfile -DestinationPath $korebuildPath
+                Microsoft.PowerShell.Archive\Expand-Archive -Path $tmpfile -DestinationPath $korebuildPath
             }
             else {
                 # Fallback to old approach for old installations of PowerShell
@@ -124,7 +140,7 @@ function Join-Paths([string]$path, [string[]]$childPaths) {
     return $path
 }
 
-function Get-RemoteFile([string]$RemotePath, [string]$LocalPath) {
+function Get-RemoteFile([string]$RemotePath, [string]$LocalPath, [string]$RemoteSuffix) {
     if ($RemotePath -notlike 'http*') {
         Copy-Item $RemotePath $LocalPath
         return
@@ -134,7 +150,7 @@ function Get-RemoteFile([string]$RemotePath, [string]$LocalPath) {
     while ($retries -gt 0) {
         $retries -= 1
         try {
-            Invoke-WebRequest -UseBasicParsing -Uri $RemotePath -OutFile $LocalPath
+            Invoke-WebRequest -UseBasicParsing -Uri $($RemotePath + $RemoteSuffix) -OutFile $LocalPath
             return
         }
         catch {
@@ -161,9 +177,11 @@ if (Test-Path $ConfigFile) {
             if (!($Channel) -and (Get-Member -Name 'channel' -InputObject $config)) { [string] $Channel = $config.channel }
             if (!($ToolsSource) -and (Get-Member -Name 'toolsSource' -InputObject $config)) { [string] $ToolsSource = $config.toolsSource}
         }
-    } catch {
-        Write-Warning "$ConfigFile could not be read. Its settings will be ignored."
-        Write-Warning $Error[0]
+    }
+    catch {
+        Write-Host -ForegroundColor Red $Error[0]
+        Write-Error "$ConfigFile contains invalid JSON."
+        exit 1
     }
 }
 
@@ -174,7 +192,7 @@ if (!$DotNetHome) {
         else { Join-Path $PSScriptRoot '.dotnet'}
 }
 
-if (!$Channel) { $Channel = 'dev' }
+if (!$Channel) { $Channel = 'master' }
 if (!$ToolsSource) { $ToolsSource = 'https://aspnetcore.blob.core.windows.net/buildtools' }
 
 # Execute
@@ -183,7 +201,7 @@ $korebuildPath = Get-KoreBuild
 Import-Module -Force -Scope Local (Join-Path $korebuildPath 'KoreBuild.psd1')
 
 try {
-    Set-KoreBuildSettings -ToolsSource $ToolsSource -DotNetHome $DotNetHome -RepoPath $Path -ConfigFile $ConfigFile
+    Set-KoreBuildSettings -ToolsSource $ToolsSource -DotNetHome $DotNetHome -RepoPath $Path -ConfigFile $ConfigFile -CI:$CI
     Invoke-KoreBuildCommand $Command @Arguments
 }
 finally {

run.sh

@@ -14,9 +14,12 @@ DIR="$( cd "$( dirname "${BASH_SOURCE[0]}" )" && pwd )"
 [ -z "${DOTNET_HOME:-}" ] && DOTNET_HOME="$HOME/.dotnet"
 verbose=false
 update=false
+reinstall=false
 repo_path="$DIR"
 channel=''
 tools_source=''
+tools_source_suffix=''
+ci=false
 
 #
 # Functions
@@ -35,7 +38,10 @@ __usage() {
     echo "    -d|--dotnet-home <DIR>                                The directory where .NET Core tools will be stored. Defaults to '\$DOTNET_HOME' or '\$HOME/.dotnet."
     echo "    --path <PATH>                                         The directory to build. Defaults to the directory containing the script."
     echo "    -s|--tools-source|-ToolsSource <URL>                  The base url where build tools can be downloaded. Overrides the value from the config file."
+    echo "    --tools-source-suffix|-ToolsSourceSuffix <SUFFIX>     The suffix to append to tools-source. Useful for query strings."
     echo "    -u|--update                                           Update to the latest KoreBuild even if the lock file is present."
+    echo "    --reinstall                                           Reinstall KoreBuild."
+    echo "    --ci                                                  Apply CI specific settings and environment variables."
     echo ""
     echo "Description:"
     echo "    This function will create a file \$DIR/korebuild-lock.txt. This lock file can be committed to source, but does not have to be."
@@ -50,7 +56,7 @@ get_korebuild() {
     local version
     local lock_file="$repo_path/korebuild-lock.txt"
     if [ ! -f "$lock_file" ] || [ "$update" = true ]; then
-        __get_remote_file "$tools_source/korebuild/channels/$channel/latest.txt" "$lock_file"
+        __get_remote_file "$tools_source/korebuild/channels/$channel/latest.txt" "$lock_file" "$tools_source_suffix"
     fi
     version="$(grep 'version:*' -m 1 "$lock_file")"
     if [[ "$version" == '' ]]; then
@@ -60,13 +66,17 @@ get_korebuild() {
     version="$(echo "${version#version:}" | sed -e 's/^[[:space:]]*//' -e 's/[[:space:]]*$//')"
     local korebuild_path="$DOTNET_HOME/buildtools/korebuild/$version"
 
+    if [ "$reinstall" = true ] && [ -d "$korebuild_path" ]; then
+        rm -rf "$korebuild_path"
+    fi
+
     {
         if [ ! -d "$korebuild_path" ]; then
             mkdir -p "$korebuild_path"
             local remote_path="$tools_source/korebuild/artifacts/$version/korebuild.$version.zip"
             tmpfile="$(mktemp)"
             echo -e "${MAGENTA}Downloading KoreBuild ${version}${RESET}"
-            if __get_remote_file "$remote_path" "$tmpfile"; then
+            if __get_remote_file "$remote_path" "$tmpfile" "$tools_source_suffix"; then
                 unzip -q -d "$korebuild_path" "$tmpfile"
             fi
             rm "$tmpfile" || true
@@ -98,6 +108,7 @@ __machine_has() {
 __get_remote_file() {
     local remote_path=$1
     local local_path=$2
+    local remote_path_suffix=$3
 
     if [[ "$remote_path" != 'http'* ]]; then
         cp "$remote_path" "$local_path"
@@ -106,14 +117,14 @@ __get_remote_file() {
 
     local failed=false
     if __machine_has wget; then
-        wget --tries 10 --quiet -O "$local_path" "$remote_path" || failed=true
+        wget --tries 10 --quiet -O "$local_path" "${remote_path}${remote_path_suffix}" || failed=true
     else
         failed=true
     fi
 
     if [ "$failed" = true ] && __machine_has curl; then
         failed=false
-        curl --retry 10 -sSL -f --create-dirs -o "$local_path" "$remote_path" || failed=true
+        curl --retry 10 -sSL -f --create-dirs -o "$local_path" "${remote_path}${remote_path_suffix}" || failed=true
     fi
 
     if [ "$failed" = true ]; then
@@ -164,9 +175,20 @@ while [[ $# -gt 0 ]]; do
             tools_source="${1:-}"
             [ -z "$tools_source" ] && __usage
             ;;
+        --tools-source-suffix|-ToolsSourceSuffix)
+            shift
+            tools_source_suffix="${1:-}"
+            [ -z "$tools_source_suffix" ] && __usage
+            ;;
         -u|--update|-Update)
             update=true
             ;;
+        --reinstall|-[Rr]einstall)
+            reinstall=true
+            ;;
+        --ci|-[Cc][Ii])
+            ci=true
+            ;;
         --verbose|-Verbose)
             verbose=true
             ;;
@@ -198,26 +220,37 @@ if [ -f "$config_file" ]; then
             config_channel="$(jq -r 'select(.channel!=null) | .channel' "$config_file")"
             config_tools_source="$(jq -r 'select(.toolsSource!=null) | .toolsSource' "$config_file")"
         else
-            __warn "$config_file is invalid JSON. Its settings will be ignored."
+            __error "$config_file contains invalid JSON."
+            exit 1
         fi
     elif __machine_has python ; then
         if python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'))" >/dev/null ; then
             config_channel="$(python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['channel'] if 'channel' in obj else '')")"
             config_tools_source="$(python -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['toolsSource'] if 'toolsSource' in obj else '')")"
         else
-            __warn "$config_file is invalid JSON. Its settings will be ignored."
+            __error "$config_file contains invalid JSON."
+            exit 1
+        fi
+    elif __machine_has python3 ; then
+        if python3 -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'))" >/dev/null ; then
+            config_channel="$(python3 -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['channel'] if 'channel' in obj else '')")"
+            config_tools_source="$(python3 -c "import json,codecs;obj=json.load(codecs.open('$config_file', 'r', 'utf-8-sig'));print(obj['toolsSource'] if 'toolsSource' in obj else '')")"
+        else
+            __error "$config_file contains invalid JSON."
+            exit 1
         fi
     else
-        __warn 'Missing required command: jq or pyton. Could not parse the JSON file. Its settings will be ignored.'
+        __error 'Missing required command: jq or python. Could not parse the JSON file.'
+        exit 1
     fi
 
     [ ! -z "${config_channel:-}" ] && channel="$config_channel"
     [ ! -z "${config_tools_source:-}" ] && tools_source="$config_tools_source"
 fi
 
-[ -z "$channel" ] && channel='dev'
+[ -z "$channel" ] && channel='master'
 [ -z "$tools_source" ] && tools_source='https://aspnetcore.blob.core.windows.net/buildtools'
 
 get_korebuild
-set_korebuildsettings "$tools_source" "$DOTNET_HOME" "$repo_path" "$config_file"
+set_korebuildsettings "$tools_source" "$DOTNET_HOME" "$repo_path" "$config_file" "$ci"
 invoke_korebuild_command "$command" "$@"

samples/misc/LatencyTest/LatencyTest.csproj

@@ -0,0 +1,19 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <IsPackable>false</IsPackable>
+    <OutputType>exe</OutputType>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\Microsoft.AspNetCore.NodeServices\Microsoft.AspNetCore.NodeServices.csproj" />
+    <ProjectReference Include="..\..\..\src\Microsoft.AspNetCore.NodeServices.Sockets\Microsoft.AspNetCore.NodeServices.Sockets.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.Extensions.DependencyInjection" Version="$(MicrosoftExtensionsDependencyInjectionPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
+  </ItemGroup>
+
+</Project>

samples/misc/LatencyTest/Program.cs

@@ -0,0 +1,52 @@
+using System;
+using System.Diagnostics;
+using System.IO;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.NodeServices;
+using Microsoft.AspNetCore.NodeServices.Sockets;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace ConsoleApplication
+{
+    // This project is a micro-benchmark for .NET->Node RPC via NodeServices. It doesn't reflect
+    // real-world usage patterns (you're not likely to make hundreds of sequential calls like this),
+    // but is a starting point for comparing the overhead of different hosting models and transports.
+    public class Program
+    {
+        public static void Main(string[] args) {
+            // Set up the DI system
+            var services = new ServiceCollection();
+            services.AddNodeServices(options => {
+                // To compare with Socket hosting, uncomment the following line
+                // Since .NET Core 1.1, the HTTP hosting model has become basically as fast as the Socket hosting model
+                //options.UseSocketHosting();
+
+                options.WatchFileExtensions = new string[] {}; // Don't watch anything
+            });
+            var serviceProvider = services.BuildServiceProvider();
+
+            // Now instantiate an INodeServices and use it
+            using (var nodeServices = serviceProvider.GetRequiredService<INodeServices>()) {
+                MeasureLatency(nodeServices).Wait();
+            }
+        }
+
+        private static async Task MeasureLatency(INodeServices nodeServices) {
+            // Ensure the connection is open, so we can measure per-request timings below
+            var response = await nodeServices.InvokeAsync<string>("latencyTest", "C#");
+            Console.WriteLine(response);
+
+            // Now perform a series of requests, capturing the time taken
+            const int requestCount = 100;
+            var watch = Stopwatch.StartNew();
+            for (var i = 0; i < requestCount; i++) {
+                await nodeServices.InvokeAsync<string>("latencyTest", "C#");
+            }
+
+            // Display results
+            var elapsedSeconds = (float)watch.ElapsedTicks / Stopwatch.Frequency;
+            Console.WriteLine("\nTotal time: {0:F2} milliseconds", 1000 * elapsedSeconds);
+            Console.WriteLine("\nTime per invocation: {0:F2} milliseconds", 1000 * elapsedSeconds / requestCount);
+        }
+    }
+}

samples/misc/LatencyTest/latencyTest.js

@@ -0,0 +1,4 @@
+module.exports = function(callback, incomingParam1) {
+    var result = 'Hello, ' + incomingParam1 + '!';
+    callback(/* error */ null, result);
+}

samples/misc/NodeServicesExamples/.gitignore

@@ -0,0 +1,2 @@
+/node_modules/
+/Properties/launchSettings.json

samples/misc/NodeServicesExamples/Controllers/HomeController.cs

@@ -0,0 +1,57 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.NodeServices;
+using Microsoft.AspNetCore.SpaServices.Prerendering;
+
+namespace NodeServicesExamples.Controllers
+{
+    public class HomeController : Controller
+    {
+        public IActionResult Index(int pageIndex)
+        {
+            return View();
+        }
+
+        public IActionResult ES2015Transpilation()
+        {
+            return View();
+        }
+
+        public async Task<IActionResult> Chart([FromServices] INodeServices nodeServices)
+        {
+            var options = new { width = 400, height = 200, showArea = true, showPoint = true, fullWidth = true };
+            var data = new
+            {
+                labels = new[] { "Mon", "Tue", "Wed", "Thu", "Fri", "Sat" },
+                series = new[] {
+                    new[] { 1, 5, 2, 5, 4, 3 },
+                    new[] { 2, 3, 4, 8, 1, 2 },
+                    new[] { 5, 4, 3, 2, 1, 0 }
+                }
+            };
+
+            ViewData["ChartMarkup"] = await nodeServices.InvokeAsync<string>("./Node/renderChart", "line", options, data);
+
+            return View();
+        }
+
+        public async Task<IActionResult> Prerendering([FromServices] ISpaPrerenderer prerenderer)
+        {
+            var result = await prerenderer.RenderToString("./Node/prerenderPage");
+
+            if (!string.IsNullOrEmpty(result.RedirectUrl))
+            {
+                return Redirect(result.RedirectUrl);
+            }
+
+            ViewData["PrerenderedHtml"] = result.Html;
+            ViewData["PrerenderedGlobals"] = result.CreateGlobalsAssignmentScript();
+            return View();
+        }
+
+        public IActionResult Error()
+        {
+            return View("~/Views/Shared/Error.cshtml");
+        }
+    }
+}

samples/misc/NodeServicesExamples/Node/prerenderPage.js

@@ -0,0 +1,14 @@
+var createServerRenderer = require('aspnet-prerendering').createServerRenderer;
+
+module.exports = createServerRenderer(function(params) {
+    return new Promise(function (resolve, reject) {
+        var message = 'The HTML was returned by the prerendering boot function. '
+            + 'The boot function received the following params:'
+            + '<pre>' + JSON.stringify(params, null, 4) + '</pre>';
+
+        resolve({
+            html: '<h3>Hello, world!</h3>' + message,
+            globals: { sampleData: { nodeVersion: process.version } }
+        });
+    });
+});

samples/misc/NodeServicesExamples/Node/renderChart.js

@@ -0,0 +1,8 @@
+var generate = require('node-chartist');
+
+module.exports = function (callback, type, options, data) {
+    generate(type, options, data).then(
+        result => callback(null, result), // Success case
+        error => callback(error)          // Error case
+    );
+};

samples/misc/NodeServicesExamples/Node/transpilation.js

@@ -0,0 +1,12 @@
+var fs = require('fs');
+var babelCore = require('babel-core');
+
+module.exports = function(cb, physicalPath, requestPath) {
+    var originalContents = fs.readFileSync(physicalPath);
+    var result = babelCore.transform(originalContents, {
+        presets: ['es2015'],
+    	sourceMaps: 'inline',
+    	sourceFileName: '/sourcemapped' + requestPath
+    });
+    cb(null, result.code);
+}

samples/misc/NodeServicesExamples/NodeServicesExamples.csproj

@@ -0,0 +1,29 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\Microsoft.AspNetCore.SpaServices\Microsoft.AspNetCore.SpaServices.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Diagnostics" Version="$(MicrosoftAspNetCoreDiagnosticsPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Hosting" Version="$(MicrosoftAspNetCoreHostingPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Server.IISIntegration" Version="$(MicrosoftAspNetCoreServerIISIntegrationPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc" Version="$(MicrosoftAspNetCoreMvcPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
+    <PackageReference Include="Microsoft.NET.Sdk.Razor" Version="$(MicrosoftNETSdkRazorPackageVersion)" PrivateAssets="All" />
+  </ItemGroup>
+
+  <Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
+    <Exec Command="npm install" />
+  </Target>
+
+</Project>

samples/misc/NodeServicesExamples/Startup.cs

@@ -0,0 +1,70 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.NodeServices;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using System.IO;
+
+namespace NodeServicesExamples
+{
+    public class Startup
+    {
+        // This method gets called by the runtime. Use this method to add services to the container.
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddMvc();
+
+            // Enable Node Services
+            services.AddNodeServices();
+            services.AddSpaPrerenderer();
+        }
+
+        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+        public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory, IHostingEnvironment env, INodeServices nodeServices)
+        {
+            app.UseDeveloperExceptionPage();
+
+            // Dynamically transpile any .js files under the '/js/' directory
+            app.Use(next => async context => {
+                var requestPath = context.Request.Path.Value;
+                if (requestPath.StartsWith("/js/") && requestPath.EndsWith(".js")) {
+                    var fileInfo = env.WebRootFileProvider.GetFileInfo(requestPath);
+                    if (fileInfo.Exists) {
+                        var transpiled = await nodeServices.InvokeAsync<string>("./Node/transpilation.js", fileInfo.PhysicalPath, requestPath);
+                        await context.Response.WriteAsync(transpiled);
+                        return;
+                    }
+                }
+
+                // Not a JS file, or doesn't exist - let some other middleware handle it
+                await next.Invoke(context);
+            });
+
+            app.UseStaticFiles();
+            app.UseMvc(routes =>
+            {
+                routes.MapRoute(
+                    name: "default",
+                    template: "{controller=Home}/{action=Index}/{id?}");
+            });
+        }
+
+        public static void Main(string[] args)
+        {
+            var host = new WebHostBuilder()
+                .ConfigureLogging(factory =>
+                {
+                    factory.AddConsole();
+                    factory.AddDebug();
+                })
+                .UseContentRoot(Directory.GetCurrentDirectory())
+                .UseIISIntegration()
+                .UseKestrel()
+                .UseStartup<Startup>()
+                .Build();
+
+            host.Run();
+        }
+    }
+}

samples/misc/NodeServicesExamples/Views/Home/Chart.cshtml

@@ -0,0 +1,12 @@
+<h1>Server-rendered chart</h1>
+
+<p>
+    This sample demonstrates how arbitrary NPM modules can be invoked from .NET code.
+</p>
+<p>
+    In this case, we use <code>node-chartist</code> to render the following chart on the server. The output is
+    identical to what you'd get if you used <a href='https://gionkunz.github.io/chartist-js/'>chartist.js</a>
+    on the client, except that in this example, we're not executing any client-side code at all.
+</p>
+
+@Html.Raw(ViewData["ChartMarkup"])

samples/misc/NodeServicesExamples/Views/Home/ES2015Transpilation.cshtml

@@ -0,0 +1,16 @@
+<h1>ES2015 Transpilation</h1>
+
+<p>
+    This sample demonstrates a way of intercepting requests for .js files and dynamically transpiling them
+    from ES2015 code to browser-compatible ES5 code using the Babel library.
+</p>
+
+<p>
+    To see that it's working, open your browser's 'Debug' console and look for the log message. This is
+    produced by the file <a href='/js/main.js'>/js/main.js</a>, which is transpiled from ES2015 dynamically
+    when requested.
+</p>
+
+@section scripts {
+    <script src='/js/main.js'></script>
+}

samples/misc/NodeServicesExamples/Views/Home/Index.cshtml

@@ -0,0 +1,13 @@
+<h1>NodeServices examples</h1>
+
+<p>
+    These examples demonstrate the direct use of the NodeServices package, independently of the usual SPA scenarios.
+    In general, NodeServices offers an efficient way to use Node-provided functionality (e.g., NPM modules) from inside
+    a .NET application.
+</p>
+
+<ul>
+    <li><a asp-action="ES2015Transpilation">ES2015 transpilation</a></li>
+    <li><a asp-action="Chart">Server-side chart rendering</a></li>
+    <li><a asp-action="Prerendering">Server-side SPA prerendering</a></li>
+</ul>

samples/misc/NodeServicesExamples/Views/Home/Prerendering.cshtml

@@ -0,0 +1,21 @@
+<h1>Server-side prerendering</h1>
+
+<p>
+    This sample demonstrates how you can invoke a JavaScript module that contains
+    prerendering logic for a Single-Page Application framework.
+</p>
+</p>
+    Your prerendering boot function will receive parameters that describe the page
+    being rendered and any data supplied by the .NET code. The return value should be
+    a promise that resolves with data to be injected into the page, such as the
+    rendered HTML and any global data that should be made available to client-side code.
+</p>
+
+@Html.Raw(ViewData["PrerenderedHtml"])
+
+<script>@Html.Raw(ViewData["PrerenderedGlobals"])</script>
+
+<script>
+    // Demonstrates how client-side code can receive data from the prerendering process
+    console.log('Received Node version from prerendering logic: ' + sampleData.nodeVersion);
+</script>

samples/misc/NodeServicesExamples/Views/Shared/Error.cshtml

@@ -0,0 +1,6 @@
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>

samples/misc/NodeServicesExamples/Views/Shared/_Layout.cshtml

@@ -0,0 +1,12 @@
+<!doctype html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <title>NodeServices Examples</title>
+        <link rel="stylesheet" href="~/css/chartist.min.css" />
+    </head>
+    <body>
+        @RenderBody()
+        @RenderSection("scripts", required: false)
+    </body>
+</html>

samples/misc/NodeServicesExamples/Views/_ViewImports.cshtml

@@ -0,0 +1,2 @@
+@using NodeServicesExamples
+@addTagHelper "*, Microsoft.AspNetCore.Mvc.TagHelpers"

samples/misc/NodeServicesExamples/Views/_ViewStart.cshtml

@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}

samples/misc/NodeServicesExamples/appsettings.json

@@ -0,0 +1 @@
+{}

samples/misc/NodeServicesExamples/jsconfig.json

@@ -0,0 +1,6 @@
+{
+    "compilerOptions": {
+        "target": "ES6",
+        "module": "commonjs"
+    }
+}

samples/misc/NodeServicesExamples/package.json

@@ -0,0 +1,10 @@
+{
+  "name": "nodeservicesexamples",
+  "version": "0.0.0",
+  "dependencies": {
+    "aspnet-prerendering": "^2.0.6",
+    "babel-core": "^6.7.4",
+    "babel-preset-es2015": "^6.6.0",
+    "node-chartist": "^1.0.2"
+  }
+}

samples/misc/NodeServicesExamples/wwwroot/js/main.js

@@ -0,0 +1,7 @@
+class Greeting {
+    getMessage() {
+        return 'Hello from the ES2015 class';
+    }
+}
+
+console.log(new Greeting().getMessage());

samples/misc/NodeServicesExamples/wwwroot/web.config

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <system.webServer>
+    <handlers>
+      <add name="httpPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified" />
+    </handlers>
+    <httpPlatform processPath="%DNX_PATH%" arguments="%DNX_ARGS%" stdoutLogEnabled="false" forwardWindowsAuthToken="false" startupTimeLimit="3600" />
+  </system.webServer>
+</configuration>

samples/misc/Webpack/.gitignore

@@ -0,0 +1,233 @@
+## Ignore Visual Studio temporary files, build results, and
+## files generated by popular Visual Studio add-ons.
+
+yarn.lock
+wwwroot/dist
+
+# User-specific files
+*.suo
+*.user
+*.userosscache
+*.sln.docstates
+
+# User-specific files (MonoDevelop/Xamarin Studio)
+*.userprefs
+
+# Build results
+[Dd]ebug/
+[Dd]ebugPublic/
+[Rr]elease/
+[Rr]eleases/
+x64/
+x86/
+build/
+bld/
+[Bb]in/
+[Oo]bj/
+
+# Visual Studio 2015 cache/options directory
+.vs/
+# Uncomment if you have tasks that create the project's static files in wwwroot
+#wwwroot/
+
+# MSTest test Results
+[Tt]est[Rr]esult*/
+[Bb]uild[Ll]og.*
+
+# NUNIT
+*.VisualState.xml
+TestResult.xml
+
+# Build Results of an ATL Project
+[Dd]ebugPS/
+[Rr]eleasePS/
+dlldata.c
+
+*_i.c
+*_p.c
+*_i.h
+*.ilk
+*.meta
+*.obj
+*.pch
+*.pdb
+*.pgc
+*.pgd
+*.rsp
+*.sbr
+*.tlb
+*.tli
+*.tlh
+*.tmp
+*.tmp_proj
+*.log
+*.vspscc
+*.vssscc
+.builds
+*.pidb
+*.svclog
+*.scc
+
+# Chutzpah Test files
+_Chutzpah*
+
+# Visual C++ cache files
+ipch/
+*.aps
+*.ncb
+*.opendb
+*.opensdf
+*.sdf
+*.cachefile
+
+# Visual Studio profiler
+*.psess
+*.vsp
+*.vspx
+*.sap
+
+# TFS 2012 Local Workspace
+$tf/
+
+# Guidance Automation Toolkit
+*.gpState
+
+# ReSharper is a .NET coding add-in
+_ReSharper*/
+*.[Rr]e[Ss]harper
+*.DotSettings.user
+
+# JustCode is a .NET coding add-in
+.JustCode
+
+# TeamCity is a build add-in
+_TeamCity*
+
+# DotCover is a Code Coverage Tool
+*.dotCover
+
+# NCrunch
+_NCrunch_*
+.*crunch*.local.xml
+nCrunchTemp_*
+
+# MightyMoose
+*.mm.*
+AutoTest.Net/
+
+# Web workbench (sass)
+.sass-cache/
+
+# Installshield output folder
+[Ee]xpress/
+
+# DocProject is a documentation generator add-in
+DocProject/buildhelp/
+DocProject/Help/*.HxT
+DocProject/Help/*.HxC
+DocProject/Help/*.hhc
+DocProject/Help/*.hhk
+DocProject/Help/*.hhp
+DocProject/Help/Html2
+DocProject/Help/html
+
+# Click-Once directory
+publish/
+
+# Publish Web Output
+*.[Pp]ublish.xml
+*.azurePubxml
+# TODO: Comment the next line if you want to checkin your web deploy settings
+# but database connection strings (with potential passwords) will be unencrypted
+*.pubxml
+*.publishproj
+
+# NuGet Packages
+*.nupkg
+# The packages folder can be ignored because of Package Restore
+**/packages/*
+# except build/, which is used as an MSBuild target.
+!**/packages/build/
+# Uncomment if necessary however generally it will be regenerated when needed
+#!**/packages/repositories.config
+
+# Microsoft Azure Build Output
+csx/
+*.build.csdef
+
+# Microsoft Azure Emulator
+ecf/
+rcf/
+
+# Microsoft Azure ApplicationInsights config file
+ApplicationInsights.config
+
+# Windows Store app package directory
+AppPackages/
+BundleArtifacts/
+
+# Visual Studio cache files
+# files ending in .cache can be ignored
+*.[Cc]ache
+# but keep track of directories ending in .cache
+!*.[Cc]ache/
+
+# Others
+ClientBin/
+~$*
+*~
+*.dbmdl
+*.dbproj.schemaview
+*.pfx
+*.publishsettings
+node_modules/
+orleans.codegen.cs
+
+# RIA/Silverlight projects
+Generated_Code/
+
+# Backup & report files from converting an old project file
+# to a newer Visual Studio version. Backup files are not needed,
+# because we have git ;-)
+_UpgradeReport_Files/
+Backup*/
+UpgradeLog*.XML
+UpgradeLog*.htm
+
+# SQL Server files
+*.mdf
+*.ldf
+
+# Business Intelligence projects
+*.rdl.data
+*.bim.layout
+*.bim_*.settings
+
+# Microsoft Fakes
+FakesAssemblies/
+
+# GhostDoc plugin setting file
+*.GhostDoc.xml
+
+# Node.js Tools for Visual Studio
+.ntvs_analysis.dat
+
+# Visual Studio 6 build log
+*.plg
+
+# Visual Studio 6 workspace options file
+*.opt
+
+# Visual Studio LightSwitch build output
+**/*.HTMLClient/GeneratedArtifacts
+**/*.DesktopClient/GeneratedArtifacts
+**/*.DesktopClient/ModelManifest.xml
+**/*.Server/GeneratedArtifacts
+**/*.Server/ModelManifest.xml
+_Pvt_Extensions
+
+# Paket dependency manager
+.paket/paket.exe
+
+# FAKE - F# Make
+.fake/

samples/misc/Webpack/ActionResults/PrerenderResult.cs

@@ -0,0 +1,51 @@
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.Http.Extensions;
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.NodeServices;
+using Microsoft.AspNetCore.SpaServices.Prerendering;
+using Microsoft.Extensions.DependencyInjection;
+
+namespace Webpack.ActionResults
+{
+    // This is an example of how you could invoke the prerendering API from an ActionResult, so as to
+    // prerender a SPA component as the entire response page (instead of injecting the SPA component
+    // into a Razor view's output)
+    public class PrerenderResult : ActionResult
+    {
+        private JavaScriptModuleExport _moduleExport;
+        private object _dataToSupply;
+
+        public PrerenderResult(JavaScriptModuleExport moduleExport, object dataToSupply = null)
+        {
+            _moduleExport = moduleExport;
+            _dataToSupply = dataToSupply;
+        }
+
+        public override async Task ExecuteResultAsync(ActionContext context)
+        {
+            var nodeServices = context.HttpContext.RequestServices.GetRequiredService<INodeServices>();
+            var hostEnv = context.HttpContext.RequestServices.GetRequiredService<IHostingEnvironment>();
+            var applicationLifetime = context.HttpContext.RequestServices.GetRequiredService<IApplicationLifetime>();
+            var applicationBasePath = hostEnv.ContentRootPath;
+            var request = context.HttpContext.Request;
+            var response = context.HttpContext.Response;
+
+            var prerenderedHtml = await Prerenderer.RenderToString(
+                applicationBasePath,
+                nodeServices,
+                applicationLifetime.ApplicationStopping,
+                _moduleExport,
+                request.GetEncodedUrl(),
+                request.Path + request.QueryString.Value,
+                _dataToSupply,
+                /* timeoutMilliseconds */ 30000,
+                /* requestPathBase */ "/"
+            );
+
+            response.ContentType = "text/html";
+            await response.WriteAsync(prerenderedHtml.Html);
+        }
+    }
+}

samples/misc/Webpack/ActionResults/PrerenderResultExtensions.cs

@@ -0,0 +1,13 @@
+using Microsoft.AspNetCore.Mvc;
+using Microsoft.AspNetCore.SpaServices.Prerendering;
+
+namespace Webpack.ActionResults
+{
+    public static class PrerenderResultExtensions
+    {
+        public static PrerenderResult Prerender(this ControllerBase controller, JavaScriptModuleExport exportToPrerender, object dataToSupply = null)
+        {
+            return new PrerenderResult(exportToPrerender, dataToSupply);
+        }
+    }
+}

samples/misc/Webpack/Clientside/App.ts

@@ -0,0 +1,4 @@
+import { HelloWorld } from './HelloWorld';
+import './styles/main.less';
+
+new HelloWorld().doIt();

samples/misc/Webpack/Clientside/HelloWorld.ts

@@ -0,0 +1,5 @@
+export class HelloWorld {
+    public doIt() {
+        console.log('Hello from MyApp');
+    }
+}

samples/misc/Webpack/Clientside/styles/main.less

@@ -0,0 +1,5 @@
+@headerColor: red;
+
+h1 {
+    color: @headerColor;
+}

samples/misc/Webpack/Controllers/HomeController.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.Mvc;
+
+namespace Webpack.Controllers
+{
+    public class HomeController : Controller
+    {
+        public IActionResult Index()
+        {
+            return View();
+        }
+    }
+}

samples/misc/Webpack/Properties/launchSettings.json

@@ -0,0 +1,25 @@
+{
+  "iisSettings": {
+    "windowsAuthentication": false,
+    "anonymousAuthentication": true,
+    "iisExpress": {
+      "applicationUrl": "http://localhost:51463/",
+      "sslPort": 0
+    }
+  },
+  "profiles": {
+    "IIS Express": {
+      "commandName": "IISExpress",
+      "launchBrowser": true,
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    },
+    "dotnet cli": {
+      "commandName": "Project",
+      "environmentVariables": {
+        "ASPNETCORE_ENVIRONMENT": "Development"
+      }
+    }
+  }
+}

samples/misc/Webpack/Startup.cs

@@ -0,0 +1,60 @@
+using Microsoft.AspNetCore.Builder;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.AspNetCore.Http;
+using Microsoft.AspNetCore.SpaServices.Webpack;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.Extensions.Logging;
+using System.IO;
+using Microsoft.AspNetCore.NodeServices;
+
+namespace Webpack
+{
+    public class Startup
+    {
+        // This method gets called by the runtime. Use this method to add services to the container.
+        public void ConfigureServices(IServiceCollection services)
+        {
+            services.AddMvc();
+            services.AddNodeServices();
+        }
+
+        // This method gets called by the runtime. Use this method to configure the HTTP request pipeline.
+        public void Configure(IApplicationBuilder app, ILoggerFactory loggerFactory, IHostingEnvironment env)
+        {
+            app.UseDeveloperExceptionPage();
+
+            // For real apps, you should only use Webpack Dev Middleware at development time. For production,
+            // you'll get better performance and reliability if you precompile the webpack output and simply
+            // serve the resulting static files. For examples of setting up this automatic switch between
+            // development-style and production-style webpack usage, see the 'templates' dir in this repo.
+            app.UseWebpackDevMiddleware(new WebpackDevMiddlewareOptions {
+                HotModuleReplacement = true
+            });
+
+            app.UseStaticFiles();
+            app.UseMvc(routes =>
+            {
+                routes.MapRoute(
+                    name: "default",
+                    template: "{controller=Home}/{action=Index}/{id?}");
+            });
+        }
+
+        public static void Main(string[] args)
+        {
+            var host = new WebHostBuilder()
+                .ConfigureLogging(factory =>
+                {
+                    factory.AddConsole();
+                    factory.AddDebug();
+                })
+                .UseContentRoot(Directory.GetCurrentDirectory())
+                .UseIISIntegration()
+                .UseKestrel()
+                .UseStartup<Startup>()
+                .Build();
+
+            host.Run();
+        }
+    }
+}

samples/misc/Webpack/Views/Home/Index.cshtml

@@ -0,0 +1,10 @@
+@{
+    ViewData["Title"] = "Home Page";
+}
+
+<h1>Hello</h1>
+Hi there. Enter some text: <input />
+
+@section scripts {
+    <script src="dist/main.js"></script>
+}

samples/misc/Webpack/Views/Shared/Error.cshtml

@@ -0,0 +1,6 @@
+@{
+    ViewData["Title"] = "Error";
+}
+
+<h1 class="text-danger">Error.</h1>
+<h2 class="text-danger">An error occurred while processing your request.</h2>

samples/misc/Webpack/Views/Shared/_Layout.cshtml

@@ -0,0 +1,14 @@
+<!DOCTYPE html>
+<html>
+    <head>
+        <meta charset="utf-8" />
+        <title>@ViewData["Title"]</title>
+        <environment names="Production">
+            <link rel="stylesheet" href="dist/my-styles.css" />
+        </environment>
+    </head>
+    <body>
+        @RenderBody()
+        @RenderSection("scripts", required: false)
+    </body>
+</html>

samples/misc/Webpack/Views/_ViewImports.cshtml

@@ -0,0 +1,2 @@
+@using Webpack
+@addTagHelper "*, Microsoft.AspNetCore.Mvc.TagHelpers"

samples/misc/Webpack/Views/_ViewStart.cshtml

@@ -0,0 +1,3 @@
+@{
+    Layout = "_Layout";
+}

samples/misc/Webpack/Webpack.csproj

@@ -0,0 +1,29 @@
+<Project Sdk="Microsoft.NET.Sdk.Web">
+
+  <PropertyGroup>
+    <TargetFramework>netcoreapp3.0</TargetFramework>
+    <TypeScriptCompileBlocked>true</TypeScriptCompileBlocked>
+    <IsPackable>false</IsPackable>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\..\..\src\Microsoft.AspNetCore.SpaServices\Microsoft.AspNetCore.SpaServices.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="Microsoft.AspNetCore.Diagnostics" Version="$(MicrosoftAspNetCoreDiagnosticsPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Hosting" Version="$(MicrosoftAspNetCoreHostingPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Server.IISIntegration" Version="$(MicrosoftAspNetCoreServerIISIntegrationPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Mvc" Version="$(MicrosoftAspNetCoreMvcPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="$(MicrosoftAspNetCoreServerKestrelPackageVersion)" />
+    <PackageReference Include="Microsoft.AspNetCore.StaticFiles" Version="$(MicrosoftAspNetCoreStaticFilesPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Debug" Version="$(MicrosoftExtensionsLoggingDebugPackageVersion)" />
+    <PackageReference Include="Microsoft.Extensions.Logging.Console" Version="$(MicrosoftExtensionsLoggingConsolePackageVersion)" />
+    <PackageReference Include="Microsoft.NET.Sdk.Razor" Version="$(MicrosoftNETSdkRazorPackageVersion)" PrivateAssets="All" />
+  </ItemGroup>
+
+  <Target Name="PrepublishScript" BeforeTargets="PrepareForPublish">
+    <Exec Command="npm install" />
+  </Target>
+
+</Project>

samples/misc/Webpack/appsettings.json

@@ -0,0 +1,10 @@
+{
+  "Logging": {
+    "IncludeScopes": false,
+    "LogLevel": {
+      "Default": "Verbose",
+      "System": "Information",
+      "Microsoft": "Information"
+    }
+  }
+}

samples/misc/Webpack/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "Webpack",
+  "version": "0.0.0",
+  "devDependencies": {
+    "css-loader": "^0.23.1",
+    "extendify": "^1.0.0",
+    "extract-text-webpack-plugin": "^1.0.1",
+    "less": "^2.6.0",
+    "less-loader": "^2.2.2",
+    "style-loader": "^0.13.0",
+    "webpack-hot-middleware": "^2.7.1"
+  },
+  "dependencies": {
+    "aspnet-prerendering": "^1.0.4",
+    "aspnet-webpack": "^1.0.3",
+    "ts-loader": "^0.8.1",
+    "typescript": "^2.0.0",
+    "webpack": "^1.13.3"
+  }
+}

samples/misc/Webpack/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "moduleResolution": "node",
+    "module": "commonjs",
+    "target": "es5",
+    "jsx": "preserve",
+    "sourceMap": true,
+    "lib": ["es6", "dom"]
+  },
+  "exclude": [
+      "node_modules"
+  ]
+}

samples/misc/Webpack/webpack.config.dev.js

@@ -0,0 +1,8 @@
+module.exports = {
+    devtool: 'inline-source-map',
+    module: {
+        loaders: [
+            { test: /\.less$/, loader: 'style-loader!css-loader!less-loader' }
+        ]
+    }
+};

samples/misc/Webpack/webpack.config.js

@@ -0,0 +1,25 @@
+var path = require('path');
+var merge = require('extendify')({ isDeep: true, arrays: 'concat' });
+var devConfig = require('./webpack.config.dev');
+var prodConfig = require('./webpack.config.prod');
+var isDevelopment = process.env.ASPNETCORE_ENVIRONMENT === 'Development';
+
+module.exports = merge({
+    resolve: {
+        extensions: [ '', '.js', '.jsx', '.ts', '.tsx' ]
+    },
+    module: {
+        loaders: [
+            { test: /\.ts(x?)$/, exclude: /node_modules/, loader: 'ts-loader?silent' }
+        ],
+    },
+    entry: {
+        main: ['./Clientside/App.ts']
+    },
+    output: {
+        path: path.join(__dirname, 'wwwroot', 'dist'),
+        filename: '[name].js',
+        publicPath: '/dist/'
+    },
+    plugins: []
+}, isDevelopment ? devConfig : prodConfig);

samples/misc/Webpack/webpack.config.prod.js

@@ -0,0 +1,15 @@
+var webpack = require('webpack');
+var ExtractTextPlugin = require('extract-text-webpack-plugin');
+var extractLESS = new ExtractTextPlugin('my-styles.css');
+
+module.exports = {
+    module: {
+        loaders: [
+            { test: /\.less$/, loader: extractLESS.extract(['css-loader', 'less-loader']) },
+        ]
+    },
+    plugins: [
+        extractLESS,
+        new webpack.optimize.UglifyJsPlugin({ minimize: true, compressor: { warnings: false } })
+    ]
+};

samples/misc/Webpack/wwwroot/web.config

@@ -0,0 +1,9 @@
+<?xml version="1.0" encoding="utf-8"?>
+<configuration>
+  <system.webServer>
+    <handlers>
+      <add name="httpPlatformHandler" path="*" verb="*" modules="httpPlatformHandler" resourceType="Unspecified"/>
+    </handlers>
+    <httpPlatform processPath="%DNX_PATH%" arguments="%DNX_ARGS%" stdoutLogEnabled="false"/>
+  </system.webServer>
+</configuration>

scripts/Regenerate-JSFiles.ps1

@@ -0,0 +1,28 @@
+[cmdletbinding(SupportsShouldProcess = $true)]
+param(
+)
+
+$ErrorActionPreference = 'Stop'
+Set-StrictMode -Version 2
+
+Push-Location "src"
+try {
+    $dirs = Get-ChildItem -Directory
+    foreach($dir in $dirs)
+    {
+        Push-Location $dir
+        try{
+            if(Test-Path -Path "package.json")
+            {
+                npm install
+                npm run build
+            }
+        }
+        finally{
+            Pop-Location
+        }
+    }
+}
+finally {
+    Pop-Location
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/.gitignore

@@ -0,0 +1,3 @@
+/bin/
+/node_modules/
+yarn.lock

src/Microsoft.AspNetCore.NodeServices.Sockets/Content/Node/entrypoint-socket.js

@@ -0,0 +1,626 @@
+(function (e, a) { for (var i in a) e[i] = a[i]; }(exports, /******/(function (modules) { // webpackBootstrap
+/******/ 	// The module cache
+/******/ 	var installedModules = {};
+/******/
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/
+/******/ 		// Check if module is in cache
+/******/ 		if (installedModules[moduleId]) {
+/******/ 			return installedModules[moduleId].exports;
+            /******/
+        }
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = installedModules[moduleId] = {
+/******/ 			i: moduleId,
+/******/ 			l: false,
+/******/ 			exports: {}
+            /******/
+        };
+/******/
+/******/ 		// Execute the module function
+/******/ 		modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
+/******/
+/******/ 		// Flag the module as loaded
+/******/ 		module.l = true;
+/******/
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+        /******/
+    }
+/******/
+/******/
+/******/ 	// expose the modules object (__webpack_modules__)
+/******/ 	__webpack_require__.m = modules;
+/******/
+/******/ 	// expose the module cache
+/******/ 	__webpack_require__.c = installedModules;
+/******/
+/******/ 	// define getter function for harmony exports
+/******/ 	__webpack_require__.d = function (exports, name, getter) {
+/******/ 		if (!__webpack_require__.o(exports, name)) {
+/******/ 			Object.defineProperty(exports, name, { enumerable: true, get: getter });
+            /******/
+        }
+        /******/
+    };
+/******/
+/******/ 	// define __esModule on exports
+/******/ 	__webpack_require__.r = function (exports) {
+/******/ 		if (typeof Symbol !== 'undefined' && Symbol.toStringTag) {
+/******/ 			Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+            /******/
+        }
+/******/ 		Object.defineProperty(exports, '__esModule', { value: true });
+        /******/
+    };
+/******/
+/******/ 	// create a fake namespace object
+/******/ 	// mode & 1: value is a module id, require it
+/******/ 	// mode & 2: merge all properties of value into the ns
+/******/ 	// mode & 4: return value when already ns object
+/******/ 	// mode & 8|1: behave like require
+/******/ 	__webpack_require__.t = function (value, mode) {
+/******/ 		if (mode & 1) value = __webpack_require__(value);
+/******/ 		if (mode & 8) return value;
+/******/ 		if ((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
+/******/ 		var ns = Object.create(null);
+/******/ 		__webpack_require__.r(ns);
+/******/ 		Object.defineProperty(ns, 'default', { enumerable: true, value: value });
+/******/ 		if (mode & 2 && typeof value != 'string') for (var key in value) __webpack_require__.d(ns, key, function (key) { return value[key]; }.bind(null, key));
+/******/ 		return ns;
+        /******/
+    };
+/******/
+/******/ 	// getDefaultExport function for compatibility with non-harmony modules
+/******/ 	__webpack_require__.n = function (module) {
+/******/ 		var getter = module && module.__esModule ?
+/******/ 			function getDefault() { return module['default']; } :
+/******/ 			function getModuleExports() { return module; };
+/******/ 		__webpack_require__.d(getter, 'a', getter);
+/******/ 		return getter;
+        /******/
+    };
+/******/
+/******/ 	// Object.prototype.hasOwnProperty.call
+/******/ 	__webpack_require__.o = function (object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
+/******/
+/******/ 	// __webpack_public_path__
+/******/ 	__webpack_require__.p = "";
+/******/
+/******/
+/******/ 	// Load entry module and return exports
+/******/ 	return __webpack_require__(__webpack_require__.s = 0);
+    /******/
+})
+/************************************************************************/
+/******/([
+/* 0 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            module.exports = __webpack_require__(1);
+
+
+            /***/
+        }),
+/* 1 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            "use strict";
+
+            exports.__esModule = true;
+            // Limit dependencies to core Node modules. This means the code in this file has to be very low-level and unattractive,
+            // but simplifies things for the consumer of this module.
+            __webpack_require__(2);
+            var net = __webpack_require__(3);
+            var path = __webpack_require__(4);
+            var readline = __webpack_require__(5);
+            var ArgsUtil_1 = __webpack_require__(6);
+            var ExitWhenParentExits_1 = __webpack_require__(7);
+            var virtualConnectionServer = __webpack_require__(8);
+            // Webpack doesn't support dynamic requires for files not present at compile time, so grab a direct
+            // reference to Node's runtime 'require' function.
+            var dynamicRequire = eval('require');
+            // Signal to the .NET side when we're ready to accept invocations
+            var server = net.createServer().on('listening', function () {
+                console.log('[Microsoft.AspNetCore.NodeServices:Listening]');
+            });
+            // Each virtual connection represents a separate invocation
+            virtualConnectionServer.createInterface(server).on('connection', function (connection) {
+                readline.createInterface(connection, null).on('line', function (line) {
+                    try {
+                        // Get a reference to the function to invoke
+                        var invocation = JSON.parse(line);
+                        var invokedModule = dynamicRequire(path.resolve(process.cwd(), invocation.moduleName));
+                        var invokedFunction = invocation.exportedFunctionName ? invokedModule[invocation.exportedFunctionName] : invokedModule;
+                        // Prepare a callback for accepting non-streamed JSON responses
+                        var hasInvokedCallback_1 = false;
+                        var invocationCallback = function (errorValue, successValue) {
+                            if (hasInvokedCallback_1) {
+                                throw new Error('Cannot supply more than one result. The callback has already been invoked,'
+                                    + ' or the result stream has already been accessed');
+                            }
+                            hasInvokedCallback_1 = true;
+                            connection.end(JSON.stringify({
+                                result: successValue,
+                                errorMessage: errorValue && (errorValue.message || errorValue),
+                                errorDetails: errorValue && (errorValue.stack || null)
+                            }));
+                        };
+                        // Also support streamed binary responses
+                        Object.defineProperty(invocationCallback, 'stream', {
+                            enumerable: true,
+                            get: function () {
+                                hasInvokedCallback_1 = true;
+                                return connection;
+                            }
+                        });
+                        // Actually invoke it, passing through any supplied args
+                        invokedFunction.apply(null, [invocationCallback].concat(invocation.args));
+                    }
+                    catch (ex) {
+                        connection.end(JSON.stringify({
+                            errorMessage: ex.message,
+                            errorDetails: ex.stack
+                        }));
+                    }
+                });
+            });
+            // Begin listening now. The underlying transport varies according to the runtime platform.
+            // On Windows it's Named Pipes; on Linux/OSX it's Domain Sockets.
+            var useWindowsNamedPipes = /^win/.test(process.platform);
+            var parsedArgs = ArgsUtil_1.parseArgs(process.argv);
+            var listenAddress = (useWindowsNamedPipes ? '\\\\.\\pipe\\' : '/tmp/') + parsedArgs.listenAddress;
+            server.listen(listenAddress);
+            ExitWhenParentExits_1.exitWhenParentExits(parseInt(parsedArgs.parentPid), /* ignoreSigint */ true);
+
+
+            /***/
+        }),
+/* 2 */
+/***/ (function (module, exports) {
+
+            // When Node writes to stdout/strerr, we capture that and convert the lines into calls on the
+            // active .NET ILogger. But by default, stdout/stderr don't have any way of distinguishing
+            // linebreaks inside log messages from the linebreaks that delimit separate log messages,
+            // so multiline strings will end up being written to the ILogger as multiple independent
+            // log messages. This makes them very hard to make sense of, especially when they represent
+            // something like stack traces.
+            //
+            // To fix this, we intercept stdout/stderr writes, and replace internal linebreaks with a
+            // marker token. When .NET receives the lines, it converts the marker tokens back to regular
+            // linebreaks within the logged messages.
+            //
+            // Note that it's better to do the interception at the stdout/stderr level, rather than at
+            // the console.log/console.error (etc.) level, because this takes place after any native
+            // message formatting has taken place (e.g., inserting values for % placeholders).
+            var findInternalNewlinesRegex = /\n(?!$)/g;
+            var encodedNewline = '__ns_newline__';
+            encodeNewlinesWrittenToStream(process.stdout);
+            encodeNewlinesWrittenToStream(process.stderr);
+            function encodeNewlinesWrittenToStream(outputStream) {
+                var origWriteFunction = outputStream.write;
+                outputStream.write = function (value) {
+                    // Only interfere with the write if it's definitely a string
+                    if (typeof value === 'string') {
+                        var argsClone = Array.prototype.slice.call(arguments, 0);
+                        argsClone[0] = encodeNewlinesInString(value);
+                        origWriteFunction.apply(this, argsClone);
+                    }
+                    else {
+                        origWriteFunction.apply(this, arguments);
+                    }
+                };
+            }
+            function encodeNewlinesInString(str) {
+                return str.replace(findInternalNewlinesRegex, encodedNewline);
+            }
+
+
+            /***/
+        }),
+/* 3 */
+/***/ (function (module, exports) {
+
+            module.exports = require("net");
+
+            /***/
+        }),
+/* 4 */
+/***/ (function (module, exports) {
+
+            module.exports = require("path");
+
+            /***/
+        }),
+/* 5 */
+/***/ (function (module, exports) {
+
+            module.exports = require("readline");
+
+            /***/
+        }),
+/* 6 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            "use strict";
+
+            exports.__esModule = true;
+            function parseArgs(args) {
+                // Very simplistic parsing which is sufficient for the cases needed. We don't want to bring in any external
+                // dependencies (such as an args-parsing library) to this file.
+                var result = {};
+                var currentKey = null;
+                args.forEach(function (arg) {
+                    if (arg.indexOf('--') === 0) {
+                        var argName = arg.substring(2);
+                        result[argName] = undefined;
+                        currentKey = argName;
+                    }
+                    else if (currentKey) {
+                        result[currentKey] = arg;
+                        currentKey = null;
+                    }
+                });
+                return result;
+            }
+            exports.parseArgs = parseArgs;
+
+
+            /***/
+        }),
+/* 7 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            "use strict";
+
+            /*
+            In general, we want the Node child processes to be terminated as soon as the parent .NET processes exit,
+            because we have no further use for them. If the .NET process shuts down gracefully, it will run its
+            finalizers, one of which (in OutOfProcessNodeInstance.cs) will kill its associated Node process immediately.
+            
+            But if the .NET process is terminated forcefully (e.g., on Linux/OSX with 'kill -9'), then it won't have
+            any opportunity to shut down its child processes, and by default they will keep running. In this case, it's
+            up to the child process to detect this has happened and terminate itself.
+            
+            There are many possible approaches to detecting when a parent process has exited, most of which behave
+            differently between Windows and Linux/OS X:
+            
+             - On Windows, the parent process can mark its child as being a 'job' that should auto-terminate when
+               the parent does (http://stackoverflow.com/a/4657392). Not cross-platform.
+             - The child Node process can get a callback when the parent disconnects (process.on('disconnect', ...)).
+               But despite http://stackoverflow.com/a/16487966, no callback fires in any case I've tested (Windows / OS X).
+             - The child Node process can get a callback when its stdin/stdout are disconnected, as described at
+               http://stackoverflow.com/a/15693934. This works well on OS X, but calling stdout.resume() on Windows
+               causes the process to terminate prematurely.
+             - I don't know why, but on Windows, it's enough to invoke process.stdin.resume(). For some reason this causes
+               the child Node process to exit as soon as the parent one does, but I don't see this documented anywhere.
+             - You can poll to see if the parent process, or your stdin/stdout connection to it, is gone
+               - You can directly pass a parent process PID to the child, and then have the child poll to see if it's
+                 still running (e.g., using process.kill(pid, 0), which doesn't kill it but just tests whether it exists,
+                 as per https://nodejs.org/api/process.html#process_process_kill_pid_signal)
+               - Or, on each poll, you can try writing to process.stdout. If the parent has died, then this will throw.
+                 However I don't see this documented anywhere. It would be nice if you could just poll for whether or not
+                 process.stdout is still connected (without actually writing to it) but I haven't found any property whose
+                 value changes until you actually try to write to it.
+            
+            Of these, the only cross-platform approach that is actually documented as a valid strategy is simply polling
+            to check whether the parent PID is still running. So that's what we do here.
+            */
+            exports.__esModule = true;
+            var pollIntervalMs = 1000;
+            function exitWhenParentExits(parentPid, ignoreSigint) {
+                setInterval(function () {
+                    if (!processExists(parentPid)) {
+                        // Can't log anything at this point, because out stdout was connected to the parent,
+                        // but the parent is gone.
+                        process.exit();
+                    }
+                }, pollIntervalMs);
+                if (ignoreSigint) {
+                    // Pressing ctrl+c in the terminal sends a SIGINT to all processes in the foreground process tree.
+                    // By default, the Node process would then exit before the .NET process, because ASP.NET implements
+                    // a delayed shutdown to allow ongoing requests to complete.
+                    //
+                    // This is problematic, because if Node exits first, the CopyToAsync code in ConditionalProxyMiddleware
+                    // will experience a read fault, and logs a huge load of errors. Fortunately, since the Node process is
+                    // already set up to shut itself down if it detects the .NET process is terminated, all we have to do is
+                    // ignore the SIGINT. The Node process will then terminate automatically after the .NET process does.
+                    //
+                    // A better solution would be to have WebpackDevMiddleware listen for SIGINT and gracefully close any
+                    // ongoing EventSource connections before letting the Node process exit, independently of the .NET
+                    // process exiting. However, doing this well in general is very nontrivial (see all the discussion at
+                    // https://github.com/nodejs/node/issues/2642).
+                    process.on('SIGINT', function () {
+                        console.log('Received SIGINT. Waiting for .NET process to exit...');
+                    });
+                }
+            }
+            exports.exitWhenParentExits = exitWhenParentExits;
+            function processExists(pid) {
+                try {
+                    // Sending signal 0 - on all platforms - tests whether the process exists. As long as it doesn't
+                    // throw, that means it does exist.
+                    process.kill(pid, 0);
+                    return true;
+                }
+                catch (ex) {
+                    // If the reason for the error is that we don't have permission to ask about this process,
+                    // report that as a separate problem.
+                    if (ex.code === 'EPERM') {
+                        throw new Error("Attempted to check whether process " + pid + " was running, but got a permissions error.");
+                    }
+                    return false;
+                }
+            }
+
+
+            /***/
+        }),
+/* 8 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            "use strict";
+
+            exports.__esModule = true;
+            var events_1 = __webpack_require__(9);
+            var VirtualConnection_1 = __webpack_require__(10);
+            // Keep this in sync with the equivalent constant in the .NET code. Both sides split up their transmissions into frames with this max length,
+            // and both will reject longer frames.
+            var MaxFrameBodyLength = 16 * 1024;
+            /**
+             * Accepts connections to a net.Server and adapts them to behave as multiplexed connections. That is, for each physical socket connection,
+             * we track a list of 'virtual connections' whose API is a Duplex stream. The remote clients may open and close as many virtual connections
+             * as they wish, reading and writing to them independently, without the overhead of establishing new physical connections each time.
+             */
+            function createInterface(server) {
+                var emitter = new events_1.EventEmitter();
+                server.on('connection', function (socket) {
+                    // For each physical socket connection, maintain a set of virtual connections. Issue a notification whenever
+                    // a new virtual connections is opened.
+                    var childSockets = new VirtualConnectionsCollection(socket, function (virtualConnection) {
+                        emitter.emit('connection', virtualConnection);
+                    });
+                });
+                return emitter;
+            }
+            exports.createInterface = createInterface;
+            /**
+             * Tracks the 'virtual connections' associated with a single physical socket connection.
+             */
+            var VirtualConnectionsCollection = /** @class */ (function () {
+                function VirtualConnectionsCollection(_socket, _onVirtualConnectionCallback) {
+                    var _this = this;
+                    this._socket = _socket;
+                    this._onVirtualConnectionCallback = _onVirtualConnectionCallback;
+                    this._currentFrameHeader = null;
+                    this._virtualConnections = {};
+                    // If the remote end closes the physical socket, treat all the virtual connections as being closed remotely too
+                    this._socket.on('close', function () {
+                        Object.getOwnPropertyNames(_this._virtualConnections).forEach(function (id) {
+                            // A 'null' frame signals that the connection was closed remotely
+                            _this._virtualConnections[id].onReceivedData(null);
+                        });
+                    });
+                    this._socket.on('readable', this._onIncomingDataAvailable.bind(this));
+                }
+                /**
+                 * This is called whenever the underlying socket signals that it may have some data available to read. It will synchronously read as many
+                 * message frames as it can from the underlying socket, opens virtual connections as needed, and dispatches data to them.
+                 */
+                VirtualConnectionsCollection.prototype._onIncomingDataAvailable = function () {
+                    var exhaustedAllData = false;
+                    while (!exhaustedAllData) {
+                        // We might already have a pending frame header from the previous time this method ran, but if not, that's the next thing we need to read
+                        if (this._currentFrameHeader === null) {
+                            this._currentFrameHeader = this._readNextFrameHeader();
+                        }
+                        if (this._currentFrameHeader === null) {
+                            // There's not enough data to fill a frameheader, so wait until more arrives later
+                            // The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
+                            exhaustedAllData = true;
+                        }
+                        else {
+                            var frameBodyLength = this._currentFrameHeader.bodyLength;
+                            var frameBodyOrNull = frameBodyLength > 0 ? this._socket.read(this._currentFrameHeader.bodyLength) : null;
+                            if (frameBodyOrNull !== null || frameBodyLength === 0) {
+                                // We have a complete frame header+body pair, so we can now dispatch this to a virtual connection. We set _currentFrameHeader back to null
+                                // so that the next thing we try to read is the next frame header.
+                                var headerCopy = this._currentFrameHeader;
+                                this._currentFrameHeader = null;
+                                this._onReceivedCompleteFrame(headerCopy, frameBodyOrNull);
+                            }
+                            else {
+                                // There's not enough data to fill the pending frame body, so wait until more arrives later
+                                // The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
+                                exhaustedAllData = true;
+                            }
+                        }
+                    }
+                };
+                VirtualConnectionsCollection.prototype._onReceivedCompleteFrame = function (header, bodyIfNotEmpty) {
+                    // An incoming zero-length frame signals that there's no more data to read.
+                    // Signal this to the Node stream APIs by pushing a 'null' chunk to it.
+                    var virtualConnection = this._getOrOpenVirtualConnection(header);
+                    virtualConnection.onReceivedData(header.bodyLength > 0 ? bodyIfNotEmpty : null);
+                };
+                VirtualConnectionsCollection.prototype._getOrOpenVirtualConnection = function (header) {
+                    if (this._virtualConnections.hasOwnProperty(header.connectionIdString)) {
+                        // It's an existing virtual connection
+                        return this._virtualConnections[header.connectionIdString];
+                    }
+                    else {
+                        // It's a new one
+                        return this._openVirtualConnection(header);
+                    }
+                };
+                VirtualConnectionsCollection.prototype._openVirtualConnection = function (header) {
+                    var _this = this;
+                    var beginWriteCallback = function (data, writeCompletedCallback) {
+                        // Only send nonempty frames, since empty ones are a signal to close the virtual connection
+                        if (data.length > 0) {
+                            _this._sendFrame(header.connectionIdBinary, data, writeCompletedCallback);
+                        }
+                    };
+                    var newVirtualConnection = new VirtualConnection_1.VirtualConnection(beginWriteCallback);
+                    newVirtualConnection.on('end', function () {
+                        // The virtual connection was closed remotely. Clean up locally.
+                        _this._onVirtualConnectionWasClosed(header.connectionIdString);
+                    });
+                    newVirtualConnection.on('finish', function () {
+                        // The virtual connection was closed locally. Clean up locally, and notify the remote that we're done.
+                        _this._onVirtualConnectionWasClosed(header.connectionIdString);
+                        _this._sendFrame(header.connectionIdBinary, Buffer.alloc(0));
+                    });
+                    this._virtualConnections[header.connectionIdString] = newVirtualConnection;
+                    this._onVirtualConnectionCallback(newVirtualConnection);
+                    return newVirtualConnection;
+                };
+                /**
+                 * Attempts to read a complete frame header, synchronously, from the underlying socket.
+                 * If not enough data is available synchronously, returns null without consuming any data from the socket.
+                 */
+                VirtualConnectionsCollection.prototype._readNextFrameHeader = function () {
+                    var headerBuf = this._socket.read(12);
+                    if (headerBuf !== null) {
+                        // We have enough data synchronously
+                        var connectionIdBinary = headerBuf.slice(0, 8);
+                        var connectionIdString = connectionIdBinary.toString('hex');
+                        var bodyLength = headerBuf.readInt32LE(8);
+                        if (bodyLength < 0 || bodyLength > MaxFrameBodyLength) {
+                            // Throwing here is going to bring down the whole process, so this cannot be allowed to happen in real use.
+                            // But it won't happen in real use, because this is only used with our .NET client, which doesn't violate this rule.
+                            throw new Error('Illegal frame body length: ' + bodyLength);
+                        }
+                        return { connectionIdBinary: connectionIdBinary, connectionIdString: connectionIdString, bodyLength: bodyLength };
+                    }
+                    else {
+                        // Not enough bytes are available synchronously, so none were consumed
+                        return null;
+                    }
+                };
+                VirtualConnectionsCollection.prototype._sendFrame = function (connectionIdBinary, data, callback) {
+                    // For all sends other than the last one, only invoke the callback if it failed.
+                    // Also, only invoke the callback at most once.
+                    var hasInvokedCallback = false;
+                    var finalCallback = callback && (function (error) {
+                        if (!hasInvokedCallback) {
+                            hasInvokedCallback = true;
+                            callback(error);
+                        }
+                    });
+                    var notFinalCallback = callback && (function (error) {
+                        if (error) {
+                            finalCallback(error);
+                        }
+                    });
+                    // The amount of data we're writing might exceed MaxFrameBodyLength, so split into frames as needed.
+                    // Note that we always send at least one frame, even if it's empty (because that's the close-virtual-connection signal).
+                    // If needed, this could be changed to send frames asynchronously, so that large sends could proceed in parallel
+                    // (though that would involve making a clone of 'data', to avoid the risk of it being mutated during the send).
+                    var bytesSent = 0;
+                    do {
+                        var nextFrameBodyLength = Math.min(MaxFrameBodyLength, data.length - bytesSent);
+                        var isFinalChunk = (bytesSent + nextFrameBodyLength) === data.length;
+                        this._socket.write(connectionIdBinary, notFinalCallback);
+                        this._sendInt32LE(nextFrameBodyLength, notFinalCallback);
+                        this._socket.write(data.slice(bytesSent, bytesSent + nextFrameBodyLength), isFinalChunk ? finalCallback : notFinalCallback);
+                        bytesSent += nextFrameBodyLength;
+                    } while (bytesSent < data.length);
+                };
+                /**
+                 * Sends a number serialized in the correct format for .NET to receive as a System.Int32
+                 */
+                VirtualConnectionsCollection.prototype._sendInt32LE = function (value, callback) {
+                    var buf = Buffer.alloc(4);
+                    buf.writeInt32LE(value, 0);
+                    this._socket.write(buf, callback);
+                };
+                VirtualConnectionsCollection.prototype._onVirtualConnectionWasClosed = function (id) {
+                    if (this._virtualConnections.hasOwnProperty(id)) {
+                        delete this._virtualConnections[id];
+                    }
+                };
+                return VirtualConnectionsCollection;
+            }());
+
+
+            /***/
+        }),
+/* 9 */
+/***/ (function (module, exports) {
+
+            module.exports = require("events");
+
+            /***/
+        }),
+/* 10 */
+/***/ (function (module, exports, __webpack_require__) {
+
+            "use strict";
+
+            var __extends = (this && this.__extends) || (function () {
+                var extendStatics = function (d, b) {
+                    extendStatics = Object.setPrototypeOf ||
+                        ({ __proto__: [] } instanceof Array && function (d, b) { d.__proto__ = b; }) ||
+                        function (d, b) { for (var p in b) if (b.hasOwnProperty(p)) d[p] = b[p]; };
+                    return extendStatics(d, b);
+                }
+                return function (d, b) {
+                    extendStatics(d, b);
+                    function __() { this.constructor = d; }
+                    d.prototype = b === null ? Object.create(b) : (__.prototype = b.prototype, new __());
+                };
+            })();
+            exports.__esModule = true;
+            var stream_1 = __webpack_require__(11);
+            /**
+             * Represents a virtual connection. Multiple virtual connections may be multiplexed over a single physical socket connection.
+             */
+            var VirtualConnection = /** @class */ (function (_super) {
+                __extends(VirtualConnection, _super);
+                function VirtualConnection(_beginWriteCallback) {
+                    var _this = _super.call(this) || this;
+                    _this._beginWriteCallback = _beginWriteCallback;
+                    _this._flowing = false;
+                    _this._receivedDataQueue = [];
+                    return _this;
+                }
+                VirtualConnection.prototype._read = function () {
+                    this._flowing = true;
+                    // Keep pushing data until we run out, or the underlying framework asks us to stop.
+                    // When we finish, the 'flowing' state is detemined by whether more data is still being requested.
+                    while (this._flowing && this._receivedDataQueue.length > 0) {
+                        var nextChunk = this._receivedDataQueue.shift();
+                        this._flowing = this.push(nextChunk);
+                    }
+                };
+                VirtualConnection.prototype._write = function (chunk, encodingIfString, callback) {
+                    if (typeof chunk === 'string') {
+                        chunk = Buffer.from(chunk, encodingIfString);
+                    }
+                    this._beginWriteCallback(chunk, callback);
+                };
+                VirtualConnection.prototype.onReceivedData = function (dataOrNullToSignalEOF) {
+                    if (this._flowing) {
+                        this._flowing = this.push(dataOrNullToSignalEOF);
+                    }
+                    else {
+                        this._receivedDataQueue.push(dataOrNullToSignalEOF);
+                    }
+                };
+                return VirtualConnection;
+            }(stream_1.Duplex));
+            exports.VirtualConnection = VirtualConnection;
+
+
+            /***/
+        }),
+/* 11 */
+/***/ (function (module, exports) {
+
+            module.exports = require("stream");
+
+            /***/
+        })
+/******/])));

src/Microsoft.AspNetCore.NodeServices.Sockets/Microsoft.AspNetCore.NodeServices.Sockets.csproj

@@ -0,0 +1,26 @@
+<Project Sdk="Microsoft.NET.Sdk">
+
+  <PropertyGroup>
+    <Description>Socket-based RPC for Microsoft.AspNetCore.NodeServices.</Description>
+    <TargetFramework>netcoreapp3.0</TargetFramework>
+  </PropertyGroup>
+
+  <ItemGroup>
+    <None Remove="node_modules\**\*" />
+    <EmbeddedResource Include="Content\**\*" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <ProjectReference Include="..\Microsoft.AspNetCore.NodeServices\Microsoft.AspNetCore.NodeServices.csproj" />
+  </ItemGroup>
+
+  <ItemGroup>
+    <PackageReference Include="System.Threading.Tasks.Dataflow" Version="$(SystemThreadingTasksDataflowPackageVersion)" />
+  </ItemGroup>
+
+  <Target Name="PrepublishScript" BeforeTargets="PrepareForPublish" Condition=" '$(IsCrossTargetingBuild)' != 'true' ">
+    <Exec Command="npm install" />
+    <Exec Command="node node_modules/webpack/bin/webpack.js" />
+  </Target>
+
+</Project>

src/Microsoft.AspNetCore.NodeServices.Sockets/PhysicalConnections/NamedPipeConnection.cs

@@ -0,0 +1,40 @@
+using System.IO;
+using System.IO.Pipes;
+using System.Threading.Tasks;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.PhysicalConnections
+{
+    internal class NamedPipeConnection : StreamConnection
+    {
+        private bool _disposedValue = false;
+        private NamedPipeClientStream _namedPipeClientStream;
+
+#pragma warning disable 1998 // Because in the NET451 code path, there's nothing to await
+        public override async Task<Stream> Open(string address)
+        {
+            _namedPipeClientStream = new NamedPipeClientStream(
+                ".",
+                address,
+                PipeDirection.InOut,
+                PipeOptions.Asynchronous);
+
+            await _namedPipeClientStream.ConnectAsync().ConfigureAwait(false);
+
+            return _namedPipeClientStream;
+        }
+#pragma warning restore 1998
+
+        public override void Dispose()
+        {
+            if (!_disposedValue)
+            {
+                if (_namedPipeClientStream != null)
+                {
+                    _namedPipeClientStream.Dispose();
+                }
+
+                _disposedValue = true;
+            }
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/PhysicalConnections/StreamConnection.cs

@@ -0,0 +1,26 @@
+using System;
+using System.IO;
+using System.Threading.Tasks;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.PhysicalConnections
+{
+    internal abstract class StreamConnection : IDisposable
+    {
+        public abstract Task<Stream> Open(string address);
+        public abstract void Dispose();
+
+        public static StreamConnection Create()
+        {
+            var useNamedPipes = System.Runtime.InteropServices.RuntimeInformation.IsOSPlatform(
+                System.Runtime.InteropServices.OSPlatform.Windows);
+            if (useNamedPipes)
+            {
+                return new NamedPipeConnection();
+            }
+            else
+            {
+                return new UnixDomainSocketConnection();
+            }
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/PhysicalConnections/UnixDomainSocketConnection.cs

@@ -0,0 +1,40 @@
+using System.IO;
+using System.Net.Sockets;
+using System.Threading.Tasks;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.PhysicalConnections
+{
+    internal class UnixDomainSocketConnection : StreamConnection
+    {
+        private bool _disposedValue = false;
+        private NetworkStream _networkStream;
+        private Socket _socket;
+
+        public override async Task<Stream> Open(string address)
+        {
+            var endPoint = new UnixDomainSocketEndPoint("/tmp/" + address);
+            _socket = new Socket(endPoint.AddressFamily, SocketType.Stream, ProtocolType.Unspecified);
+            await _socket.ConnectAsync(endPoint).ConfigureAwait(false);
+            _networkStream = new NetworkStream(_socket);
+            return _networkStream;
+        }
+
+        public override void Dispose()
+        {
+            if (!_disposedValue)
+            {
+                if (_networkStream != null)
+                {
+                    _networkStream.Dispose();
+                }
+
+                if (_socket != null)
+                {
+                    _socket.Dispose();
+                }
+
+                _disposedValue = true;
+            }
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/PhysicalConnections/UnixDomainSocketEndPoint.cs

@@ -0,0 +1,86 @@
+using System;
+using System.Net;
+using System.Net.Sockets;
+using System.Text;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.PhysicalConnections
+{
+    // From System.IO.Pipes/src/System/Net/Sockets/UnixDomainSocketEndPoint.cs (an internal class in System.IO.Pipes)
+    internal sealed class UnixDomainSocketEndPoint : EndPoint
+    {
+        private const AddressFamily EndPointAddressFamily = AddressFamily.Unix;
+
+        private static readonly Encoding s_pathEncoding = Encoding.UTF8;
+        private static readonly int s_nativePathOffset = 2; // = offsetof(struct sockaddr_un, sun_path). It's the same on Linux and OSX
+        private static readonly int s_nativePathLength = 91; // sockaddr_un.sun_path at http://pubs.opengroup.org/onlinepubs/9699919799/basedefs/sys_un.h.html, -1 for terminator
+        private static readonly int s_nativeAddressSize = s_nativePathOffset + s_nativePathLength;
+
+        private readonly string _path;
+        private readonly byte[] _encodedPath;
+
+        public UnixDomainSocketEndPoint(string path)
+        {
+            if (path == null)
+            {
+                throw new ArgumentNullException(nameof(path));
+            }
+
+            _path = path;
+            _encodedPath = s_pathEncoding.GetBytes(_path);
+
+            if (path.Length == 0 || _encodedPath.Length > s_nativePathLength)
+            {
+                throw new ArgumentOutOfRangeException(nameof(path));
+            }
+        }
+
+        internal UnixDomainSocketEndPoint(SocketAddress socketAddress)
+        {
+            if (socketAddress == null)
+            {
+                throw new ArgumentNullException(nameof(socketAddress));
+            }
+
+            if (socketAddress.Family != EndPointAddressFamily ||
+                socketAddress.Size > s_nativeAddressSize)
+            {
+                throw new ArgumentOutOfRangeException(nameof(socketAddress));
+            }
+
+            if (socketAddress.Size > s_nativePathOffset)
+            {
+                _encodedPath = new byte[socketAddress.Size - s_nativePathOffset];
+                for (int i = 0; i < _encodedPath.Length; i++)
+                {
+                    _encodedPath[i] = socketAddress[s_nativePathOffset + i];
+                }
+
+                _path = s_pathEncoding.GetString(_encodedPath, 0, _encodedPath.Length);
+            }
+            else
+            {
+                _encodedPath = Array.Empty<byte>();
+                _path = string.Empty;
+            }
+        }
+
+        public override SocketAddress Serialize()
+        {
+            var result = new SocketAddress(AddressFamily.Unix, s_nativeAddressSize);
+
+            for (int index = 0; index < _encodedPath.Length; index++)
+            {
+                result[s_nativePathOffset + index] = _encodedPath[index];
+            }
+            result[s_nativePathOffset + _encodedPath.Length] = 0; // path must be null-terminated
+
+            return result;
+        }
+
+        public override EndPoint Create(SocketAddress socketAddress) => new UnixDomainSocketEndPoint(socketAddress);
+
+        public override AddressFamily AddressFamily => EndPointAddressFamily;
+
+        public override string ToString() => _path;
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/SocketNodeInstance.cs

@@ -0,0 +1,240 @@
+using System.IO;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.AspNetCore.NodeServices.HostingModels;
+using Microsoft.AspNetCore.NodeServices.Sockets.PhysicalConnections;
+using Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections;
+using Microsoft.Extensions.Logging;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Serialization;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets
+{
+    /// <summary>
+    /// A specialisation of the OutOfProcessNodeInstance base class that uses a lightweight binary streaming protocol
+    /// to perform RPC invocations. The physical transport is Named Pipes on Windows, or Domain Sockets on Linux/Mac.
+    /// For details on the binary streaming protocol, see <see cref="Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections.VirtualConnectionClient" />
+    /// The advantage versus using HTTP for RPC is that this is faster (not surprisingly - there's much less overhead
+    /// because we don't need most of the functionality of HTTP.
+    ///
+    /// The address of the pipe/socket is selected randomly here on the .NET side and sent to the child process as a
+    /// command-line argument (the address space is wide enough that there's no real risk of a clash, unlike when
+    /// selecting TCP port numbers).
+    /// </summary>
+    /// <seealso cref="Microsoft.AspNetCore.NodeServices.HostingModels.OutOfProcessNodeInstance" />
+    internal class SocketNodeInstance : OutOfProcessNodeInstance
+    {
+        private readonly static JsonSerializerSettings jsonSerializerSettings = new JsonSerializerSettings
+        {
+            ContractResolver = new CamelCasePropertyNamesContractResolver(),
+            TypeNameHandling = TypeNameHandling.None
+        };
+
+        private readonly static int streamBufferSize = 16 * 1024;
+        private readonly static UTF8Encoding utf8EncodingWithoutBom = new UTF8Encoding(false);
+
+        private readonly SemaphoreSlim _connectionCreationSemaphore = new SemaphoreSlim(1);
+        private bool _connectionHasFailed;
+        private StreamConnection _physicalConnection;
+        private string _socketAddress;
+        private VirtualConnectionClient _virtualConnectionClient;
+
+        public SocketNodeInstance(NodeServicesOptions options, string socketAddress)
+        : base(
+                EmbeddedResourceReader.Read(
+                    typeof(SocketNodeInstance),
+                    "/Content/Node/entrypoint-socket.js"),
+                options.ProjectPath,
+                options.WatchFileExtensions,
+                MakeNewCommandLineOptions(socketAddress),
+                options.ApplicationStoppingToken,
+                options.NodeInstanceOutputLogger,
+                options.EnvironmentVariables,
+                options.InvocationTimeoutMilliseconds,
+                options.LaunchWithDebugging,
+                options.DebuggingPort)
+        {
+            _socketAddress = socketAddress;
+        }
+
+        protected override async Task<T> InvokeExportAsync<T>(NodeInvocationInfo invocationInfo, CancellationToken cancellationToken)
+        {
+            if (_connectionHasFailed)
+            {
+                // _connectionHasFailed implies a protocol-level error. The old instance is no longer of any use.
+                var allowConnectionDraining = false;
+
+                // This special exception type forces NodeServicesImpl to restart the Node instance
+                throw new NodeInvocationException(
+                    "The SocketNodeInstance socket connection failed. See logs to identify the reason.",
+                    details: null,
+                    nodeInstanceUnavailable: true,
+                    allowConnectionDraining: allowConnectionDraining);
+            }
+
+            if (_virtualConnectionClient == null)
+            {
+                // Although we could pass the cancellationToken into EnsureVirtualConnectionClientCreated and
+                // have it signal cancellations upstream, that would be a bad thing to do, because all callers
+                // wait for the same connection task. There's no reason why the first caller should have the
+                // special ability to cancel the connection process in a way that would affect subsequent
+                // callers. So, each caller just independently stops awaiting connection if that call is cancelled.
+                await ThrowOnCancellation(EnsureVirtualConnectionClientCreated(), cancellationToken);
+            }
+
+            // For each invocation, we open a new virtual connection. This gives an API equivalent to opening a new
+            // physical connection to the child process, but without the overhead of doing so, because it's really
+            // just multiplexed into the existing physical connection stream.
+            bool shouldDisposeVirtualConnection = true;
+            Stream virtualConnection = null;
+            try
+            {
+                virtualConnection = _virtualConnectionClient.OpenVirtualConnection();
+
+                // Send request
+                WriteJsonLine(virtualConnection, invocationInfo);
+
+                // Determine what kind of response format is expected
+                if (typeof(T) == typeof(Stream))
+                {
+                    // Pass through streamed binary response
+                    // It is up to the consumer to dispose this stream, so don't do so here
+                    shouldDisposeVirtualConnection = false;
+                    return (T)(object)virtualConnection;
+                }
+                else
+                {
+                    // Parse and return non-streamed JSON response
+                    var response = await ReadJsonAsync<RpcJsonResponse<T>>(virtualConnection, cancellationToken);
+                    if (response.ErrorMessage != null)
+                    {
+                        throw new NodeInvocationException(response.ErrorMessage, response.ErrorDetails);
+                    }
+
+                    return response.Result;
+                }
+            }
+            finally
+            {
+                if (shouldDisposeVirtualConnection)
+                {
+                    virtualConnection.Dispose();
+                }
+            }
+        }
+
+        private async Task EnsureVirtualConnectionClientCreated()
+        {
+            // Asynchronous equivalent to a 'lock(...) { ... }'
+            await _connectionCreationSemaphore.WaitAsync();
+            try
+            {
+                if (_virtualConnectionClient == null)
+                {
+                    _physicalConnection = StreamConnection.Create();
+
+                    var connection = await _physicalConnection.Open(_socketAddress);
+                    _virtualConnectionClient = new VirtualConnectionClient(connection);
+                    _virtualConnectionClient.OnError += (ex) =>
+                    {
+                        // This callback is fired only if there's a protocol-level failure (e.g., child process disconnected
+                        // unexpectedly). It does *not* fire when RPC calls return errors. Since there's been a protocol-level
+                        // failure, this Node instance is no longer usable and should be discarded.
+                        _connectionHasFailed = true;
+
+                        OutputLogger.LogError(0, ex, ex.Message);
+                    };
+                }
+            }
+            finally
+            {
+                _connectionCreationSemaphore.Release();
+            }
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing)
+            {
+                if (_virtualConnectionClient != null)
+                {
+                    _virtualConnectionClient.Dispose();
+                    _virtualConnectionClient = null;
+                }
+
+                if (_physicalConnection != null)
+                {
+                    _physicalConnection.Dispose();
+                    _physicalConnection = null;
+                }
+            }
+
+            base.Dispose(disposing);
+        }
+
+        private static void WriteJsonLine(Stream stream, object serializableObject)
+        {
+            using (var streamWriter = new StreamWriter(stream, utf8EncodingWithoutBom, streamBufferSize, true))
+            using (var jsonWriter = new JsonTextWriter(streamWriter))
+            {
+                jsonWriter.CloseOutput = false;
+                jsonWriter.AutoCompleteOnClose = false;
+
+                var serializer = JsonSerializer.Create(jsonSerializerSettings);
+                serializer.Serialize(jsonWriter, serializableObject);
+                jsonWriter.Flush();
+
+                streamWriter.WriteLine();
+                streamWriter.Flush();
+            }
+        }
+
+        private static async Task<T> ReadJsonAsync<T>(Stream stream, CancellationToken cancellationToken)
+        {
+            var json = Encoding.UTF8.GetString(await ReadAllBytesAsync(stream, cancellationToken));
+            return JsonConvert.DeserializeObject<T>(json, jsonSerializerSettings);
+        }
+
+        private static async Task<byte[]> ReadAllBytesAsync(Stream input, CancellationToken cancellationToken)
+        {
+            byte[] buffer = new byte[streamBufferSize];
+
+            using (var ms = new MemoryStream())
+            {
+                int read;
+                while ((read = await input.ReadAsync(buffer, 0, buffer.Length, cancellationToken)) > 0)
+                {
+                    ms.Write(buffer, 0, read);
+                }
+
+                return ms.ToArray();
+            }
+        }
+
+        private static string MakeNewCommandLineOptions(string listenAddress)
+        {
+            return $"--listenAddress {listenAddress}";
+        }
+
+        private static Task ThrowOnCancellation(Task task, CancellationToken cancellationToken)
+        {
+            return task.IsCompleted
+                ? task // If the task is already completed, no need to wrap it in a further layer of task
+                : task.ContinueWith(
+                    _ => {}, // If the task completes, allow execution to continue
+                    cancellationToken,
+                    TaskContinuationOptions.ExecuteSynchronously,
+                    TaskScheduler.Default);
+        }
+
+#pragma warning disable 649 // These properties are populated via JSON deserialization
+        private class RpcJsonResponse<TResult>
+        {
+            public TResult Result { get; set; }
+            public string ErrorMessage { get; set; }
+            public string ErrorDetails { get; set; }
+        }
+#pragma warning restore 649
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/SocketNodeServicesOptionsExtensions.cs

@@ -0,0 +1,21 @@
+using System;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets
+{
+    /// <summary>
+    /// Extension methods that help with populating a <see cref="NodeServicesOptions"/> object.
+    /// </summary>
+    public static class NodeServicesOptionsExtensions
+    {
+        /// <summary>
+        /// Configures the <see cref="INodeServices"/> service so that it will use out-of-process
+        /// Node.js instances and perform RPC calls over binary sockets (on Windows, this is
+        /// implemented as named pipes; on other platforms it uses domain sockets).
+        /// </summary>
+        public static void UseSocketHosting(this NodeServicesOptions options)
+        {
+            var pipeName = "pni-" + Guid.NewGuid().ToString("D"); // Arbitrary non-clashing string
+            options.NodeInstanceFactory = () => new SocketNodeInstance(options, pipeName);
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/TypeScript/SocketNodeInstanceEntryPoint.ts

@@ -0,0 +1,79 @@
+// Limit dependencies to core Node modules. This means the code in this file has to be very low-level and unattractive,
+// but simplifies things for the consumer of this module.
+import '../../Microsoft.AspNetCore.NodeServices/TypeScript/Util/OverrideStdOutputs';
+import * as net from 'net';
+import * as path from 'path';
+import * as readline from 'readline';
+import { Duplex } from 'stream';
+import { parseArgs } from '../../Microsoft.AspNetCore.NodeServices/TypeScript/Util/ArgsUtil';
+import { exitWhenParentExits } from '../../Microsoft.AspNetCore.NodeServices/TypeScript/Util/ExitWhenParentExits';
+import * as virtualConnectionServer from './VirtualConnections/VirtualConnectionServer';
+
+// Webpack doesn't support dynamic requires for files not present at compile time, so grab a direct
+// reference to Node's runtime 'require' function.
+const dynamicRequire: (name: string) => any = eval('require');
+
+// Signal to the .NET side when we're ready to accept invocations
+const server = net.createServer().on('listening', () => {
+    console.log('[Microsoft.AspNetCore.NodeServices:Listening]');
+});
+
+// Each virtual connection represents a separate invocation
+virtualConnectionServer.createInterface(server).on('connection', (connection: Duplex) => {
+    readline.createInterface(connection, null).on('line', line => {
+        try {
+            // Get a reference to the function to invoke
+            const invocation = JSON.parse(line) as RpcInvocation;
+            const invokedModule = dynamicRequire(path.resolve(process.cwd(), invocation.moduleName));
+            const invokedFunction = invocation.exportedFunctionName ? invokedModule[invocation.exportedFunctionName] : invokedModule;
+
+            // Prepare a callback for accepting non-streamed JSON responses
+            let hasInvokedCallback = false;
+            const invocationCallback = (errorValue, successValue) => {
+                if (hasInvokedCallback) {
+                    throw new Error('Cannot supply more than one result. The callback has already been invoked,'
+                        + ' or the result stream has already been accessed');
+                }
+
+                hasInvokedCallback = true;
+                connection.end(JSON.stringify({
+                    result: successValue,
+                    errorMessage: errorValue && (errorValue.message || errorValue),
+                    errorDetails: errorValue && (errorValue.stack || null)
+                }));
+            };
+
+            // Also support streamed binary responses
+            Object.defineProperty(invocationCallback, 'stream', {
+                enumerable: true,
+                get: (): Duplex => {
+                    hasInvokedCallback = true;
+                    return connection;
+                }
+            });
+
+            // Actually invoke it, passing through any supplied args
+            invokedFunction.apply(null, [invocationCallback].concat(invocation.args));
+        } catch (ex) {
+            connection.end(JSON.stringify({
+                errorMessage: ex.message,
+                errorDetails: ex.stack
+            }));
+        }
+    });
+});
+
+// Begin listening now. The underlying transport varies according to the runtime platform.
+// On Windows it's Named Pipes; on Linux/OSX it's Domain Sockets.
+const useWindowsNamedPipes = /^win/.test(process.platform);
+const parsedArgs = parseArgs(process.argv);
+const listenAddress = (useWindowsNamedPipes ? '\\\\.\\pipe\\' : '/tmp/') + parsedArgs.listenAddress;
+server.listen(listenAddress);
+
+exitWhenParentExits(parseInt(parsedArgs.parentPid), /* ignoreSigint */ true);
+
+interface RpcInvocation {
+    moduleName: string;
+    exportedFunctionName: string;
+    args: any[];
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/TypeScript/VirtualConnections/VirtualConnection.ts

@@ -0,0 +1,43 @@
+import { Duplex } from 'stream';
+
+export type EndWriteCallback = (error?: any) => void;
+export type BeginWriteCallback = (data: Buffer, callback: EndWriteCallback) => void;
+
+/**
+ * Represents a virtual connection. Multiple virtual connections may be multiplexed over a single physical socket connection.
+ */
+export class VirtualConnection extends Duplex {
+    private _flowing = false;
+    private _receivedDataQueue: Buffer[] = [];
+
+    constructor(private _beginWriteCallback: BeginWriteCallback) {
+        super();
+    }
+
+    public _read() {
+        this._flowing = true;
+
+        // Keep pushing data until we run out, or the underlying framework asks us to stop.
+        // When we finish, the 'flowing' state is detemined by whether more data is still being requested.
+        while (this._flowing && this._receivedDataQueue.length > 0) {
+            const nextChunk = this._receivedDataQueue.shift();
+            this._flowing = this.push(nextChunk);
+        }
+    }
+
+    public _write(chunk: Buffer | string, encodingIfString: string, callback: EndWriteCallback) {
+        if (typeof chunk === 'string') {
+            chunk = Buffer.from(chunk as string, encodingIfString);
+        }
+
+        this._beginWriteCallback(chunk as Buffer, callback);
+    }
+
+    public onReceivedData(dataOrNullToSignalEOF: Buffer) {
+        if (this._flowing) {
+            this._flowing = this.push(dataOrNullToSignalEOF);
+        } else {
+            this._receivedDataQueue.push(dataOrNullToSignalEOF);
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/TypeScript/VirtualConnections/VirtualConnectionServer.ts

@@ -0,0 +1,199 @@
+import { Server, Socket } from 'net';
+import { EventEmitter } from 'events';
+import { Duplex } from 'stream';
+import { VirtualConnection, EndWriteCallback } from './VirtualConnection';
+
+// Keep this in sync with the equivalent constant in the .NET code. Both sides split up their transmissions into frames with this max length,
+// and both will reject longer frames.
+const MaxFrameBodyLength = 16 * 1024;
+
+/**
+ * Accepts connections to a net.Server and adapts them to behave as multiplexed connections. That is, for each physical socket connection,
+ * we track a list of 'virtual connections' whose API is a Duplex stream. The remote clients may open and close as many virtual connections
+ * as they wish, reading and writing to them independently, without the overhead of establishing new physical connections each time.
+ */
+export function createInterface(server: Server): EventEmitter {
+    const emitter = new EventEmitter();
+
+    server.on('connection', (socket: Socket) => {
+        // For each physical socket connection, maintain a set of virtual connections. Issue a notification whenever
+        // a new virtual connections is opened.
+        const childSockets = new VirtualConnectionsCollection(socket, virtualConnection => {
+            emitter.emit('connection', virtualConnection);
+        });
+    });
+
+    return emitter;
+}
+
+/**
+ * Tracks the 'virtual connections' associated with a single physical socket connection.
+ */
+class VirtualConnectionsCollection {
+    private _currentFrameHeader: FrameHeader = null;
+    private _virtualConnections: { [id: string]: VirtualConnection } = {};
+
+    constructor(private _socket: Socket, private _onVirtualConnectionCallback: (virtualConnection: Duplex) => void) {
+        // If the remote end closes the physical socket, treat all the virtual connections as being closed remotely too
+        this._socket.on('close', () => {
+            Object.getOwnPropertyNames(this._virtualConnections).forEach(id => {
+                // A 'null' frame signals that the connection was closed remotely
+                this._virtualConnections[id].onReceivedData(null);
+            });
+        });
+
+        this._socket.on('readable', this._onIncomingDataAvailable.bind(this));
+    }
+
+    /**
+     * This is called whenever the underlying socket signals that it may have some data available to read. It will synchronously read as many
+     * message frames as it can from the underlying socket, opens virtual connections as needed, and dispatches data to them.
+     */
+    private _onIncomingDataAvailable() {
+        let exhaustedAllData = false;
+
+        while (!exhaustedAllData) {
+            // We might already have a pending frame header from the previous time this method ran, but if not, that's the next thing we need to read
+            if (this._currentFrameHeader === null) {
+                this._currentFrameHeader = this._readNextFrameHeader();
+            }
+
+            if (this._currentFrameHeader === null) {
+                // There's not enough data to fill a frameheader, so wait until more arrives later
+                // The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
+                exhaustedAllData = true;
+            } else {
+                const frameBodyLength = this._currentFrameHeader.bodyLength;
+                const frameBodyOrNull: Buffer = frameBodyLength > 0 ? this._socket.read(this._currentFrameHeader.bodyLength) : null;
+                if (frameBodyOrNull !== null || frameBodyLength === 0) {
+                    // We have a complete frame header+body pair, so we can now dispatch this to a virtual connection. We set _currentFrameHeader back to null
+                    // so that the next thing we try to read is the next frame header.
+                    const headerCopy = this._currentFrameHeader;
+                    this._currentFrameHeader = null;
+                    this._onReceivedCompleteFrame(headerCopy, frameBodyOrNull);
+                } else {
+                    // There's not enough data to fill the pending frame body, so wait until more arrives later
+                    // The next attempt to read from the socket will start from the same place this one did (incomplete reads don't consume any data)
+                    exhaustedAllData = true;
+                }
+            }
+        }
+    }
+
+    private _onReceivedCompleteFrame(header: FrameHeader, bodyIfNotEmpty: Buffer) {
+        // An incoming zero-length frame signals that there's no more data to read.
+        // Signal this to the Node stream APIs by pushing a 'null' chunk to it.
+        const virtualConnection = this._getOrOpenVirtualConnection(header);
+        virtualConnection.onReceivedData(header.bodyLength > 0 ? bodyIfNotEmpty : null);
+    }
+
+    private _getOrOpenVirtualConnection(header: FrameHeader) {
+        if (this._virtualConnections.hasOwnProperty(header.connectionIdString)) {
+            // It's an existing virtual connection
+            return this._virtualConnections[header.connectionIdString];
+        } else {
+            // It's a new one
+            return this._openVirtualConnection(header);
+        }
+    }
+
+    private _openVirtualConnection(header: FrameHeader) {
+        const beginWriteCallback = (data, writeCompletedCallback) => {
+            // Only send nonempty frames, since empty ones are a signal to close the virtual connection
+            if (data.length > 0) {
+                this._sendFrame(header.connectionIdBinary, data, writeCompletedCallback);
+            }
+        };
+
+        const newVirtualConnection = new VirtualConnection(beginWriteCallback);
+        newVirtualConnection.on('end', () => {
+            // The virtual connection was closed remotely. Clean up locally.
+            this._onVirtualConnectionWasClosed(header.connectionIdString);
+        });
+        newVirtualConnection.on('finish', () => {
+            // The virtual connection was closed locally. Clean up locally, and notify the remote that we're done.
+            this._onVirtualConnectionWasClosed(header.connectionIdString);
+            this._sendFrame(header.connectionIdBinary, Buffer.alloc(0));
+        });
+
+        this._virtualConnections[header.connectionIdString] = newVirtualConnection;
+        this._onVirtualConnectionCallback(newVirtualConnection);
+        return newVirtualConnection;
+    }
+
+    /**
+     * Attempts to read a complete frame header, synchronously, from the underlying socket.
+     * If not enough data is available synchronously, returns null without consuming any data from the socket.
+     */
+    private _readNextFrameHeader(): FrameHeader {
+        const headerBuf: Buffer = this._socket.read(12);
+        if (headerBuf !== null) {
+            // We have enough data synchronously
+            const connectionIdBinary = headerBuf.slice(0, 8);
+            const connectionIdString = connectionIdBinary.toString('hex');
+            const bodyLength = headerBuf.readInt32LE(8);
+            if (bodyLength < 0 || bodyLength > MaxFrameBodyLength) {
+                // Throwing here is going to bring down the whole process, so this cannot be allowed to happen in real use.
+                // But it won't happen in real use, because this is only used with our .NET client, which doesn't violate this rule.
+                throw new Error('Illegal frame body length: ' + bodyLength);
+            }
+
+            return { connectionIdBinary, connectionIdString, bodyLength };
+        } else {
+            // Not enough bytes are available synchronously, so none were consumed
+            return null;
+        }
+    }
+
+    private _sendFrame(connectionIdBinary: Buffer, data: Buffer, callback?: EndWriteCallback) {
+        // For all sends other than the last one, only invoke the callback if it failed.
+        // Also, only invoke the callback at most once.
+        let hasInvokedCallback = false;
+        const finalCallback: EndWriteCallback = callback && (error => {
+            if (!hasInvokedCallback) {
+                hasInvokedCallback = true;
+                callback(error);
+            }
+        });
+        const notFinalCallback: EndWriteCallback = callback && (error => {
+            if (error) {
+                finalCallback(error);
+            }
+        });
+
+        // The amount of data we're writing might exceed MaxFrameBodyLength, so split into frames as needed.
+        // Note that we always send at least one frame, even if it's empty (because that's the close-virtual-connection signal).
+        // If needed, this could be changed to send frames asynchronously, so that large sends could proceed in parallel
+        // (though that would involve making a clone of 'data', to avoid the risk of it being mutated during the send).
+        let bytesSent = 0;
+        do {
+            const nextFrameBodyLength = Math.min(MaxFrameBodyLength, data.length - bytesSent);
+            const isFinalChunk = (bytesSent + nextFrameBodyLength) === data.length;
+            this._socket.write(connectionIdBinary, notFinalCallback);
+            this._sendInt32LE(nextFrameBodyLength, notFinalCallback);
+            this._socket.write(data.slice(bytesSent, bytesSent + nextFrameBodyLength), isFinalChunk ? finalCallback : notFinalCallback);
+            bytesSent += nextFrameBodyLength;
+        } while (bytesSent < data.length);
+    }
+
+    /**
+     * Sends a number serialized in the correct format for .NET to receive as a System.Int32
+     */
+    private _sendInt32LE(value: number, callback?: EndWriteCallback) {
+        const buf = Buffer.alloc(4);
+        buf.writeInt32LE(value, 0);
+        this._socket.write(buf, callback);
+    }
+
+    private _onVirtualConnectionWasClosed(id: string) {
+        if (this._virtualConnections.hasOwnProperty(id)) {
+            delete this._virtualConnections[id];
+        }
+    }
+}
+
+interface FrameHeader {
+    connectionIdBinary: Buffer;
+    connectionIdString: string;
+    bodyLength: number;
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/TypeScript/tsconfig.json

@@ -0,0 +1,11 @@
+{
+    "compilerOptions": {
+        "target": "es3",
+        "module": "commonjs",
+        "moduleResolution": "node",
+        "types": ["node"]
+    },
+    "exclude": [
+        "node_modules"
+    ]
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/VirtualConnections/VirtualConnection.cs

@@ -0,0 +1,150 @@
+using System;
+using System.IO;
+using System.Threading;
+using System.Threading.Tasks;
+using System.Threading.Tasks.Dataflow;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections
+{
+    /// <summary>
+    /// A virtual read/write connection, typically to a remote process. Multiple virtual connections can be
+    /// multiplexed over a single physical connection (e.g., a named pipe, domain socket, or TCP socket).
+    /// </summary>
+    internal class VirtualConnection : Stream
+    {
+        private readonly static Task CompletedTask = Task.CompletedTask;
+        private VirtualConnectionClient _host;
+        private readonly BufferBlock<byte[]> _receivedDataQueue = new BufferBlock<byte[]>();
+        private ArraySegment<byte> _receivedDataNotYetUsed;
+        private bool _wasClosedByRemote;
+        private bool _isDisposed;
+
+        public VirtualConnection(long id, VirtualConnectionClient host)
+        {
+            Id = id;
+            _host = host;
+        }
+
+        public long Id { get; }
+
+        public override bool CanRead { get { return true; } }
+        public override bool CanSeek { get { return false; } }
+        public override bool CanWrite { get { return true; } }
+
+        public override long Length
+        {
+            get { throw new NotImplementedException(); }
+        }
+
+        public override long Position
+        {
+            get { throw new NotImplementedException(); }
+            set { throw new NotImplementedException(); }
+        }
+
+        public override void Flush()
+        {
+            // We're auto-flushing, so this is a no-op.
+        }
+
+        public override async Task<int> ReadAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+        {
+            if (_wasClosedByRemote)
+            {
+                return 0;
+            }
+
+            var bytesRead = 0;
+            while (true)
+            {
+                // Pull as many applicable bytes as we can out of receivedDataNotYetUsed, then update its offset/length
+                int bytesToExtract = Math.Min(count - bytesRead, _receivedDataNotYetUsed.Count);
+                if (bytesToExtract > 0)
+                {
+                    Buffer.BlockCopy(_receivedDataNotYetUsed.Array, _receivedDataNotYetUsed.Offset, buffer, bytesRead, bytesToExtract);
+                    _receivedDataNotYetUsed = new ArraySegment<byte>(_receivedDataNotYetUsed.Array, _receivedDataNotYetUsed.Offset + bytesToExtract, _receivedDataNotYetUsed.Count - bytesToExtract);
+                    bytesRead += bytesToExtract;
+                }
+
+                // If we've completely filled the output buffer, we're done
+                if (bytesRead == count)
+                {
+                    return bytesRead;
+                }
+
+                // We haven't yet filled the output buffer, so we must have exhausted receivedDataNotYetUsed instead.
+                // We want to get the next block of data from the underlying queue.
+                byte[] nextReceivedBlock;
+                if (bytesRead > 0)
+                {
+                    if (!_receivedDataQueue.TryReceive(null, out nextReceivedBlock))
+                    {
+                        // No more data is available synchronously, and we already have some data, so we can stop now
+                        return bytesRead;
+                    }
+                }
+                else
+                {
+                    // Since we don't yet have anything, wait for the underlying source
+                    nextReceivedBlock = await _receivedDataQueue.ReceiveAsync(cancellationToken);
+                }
+
+                if (nextReceivedBlock.Length == 0)
+                {
+                    // A zero-length block signals that the remote regards this virtual connection as closed
+                    _wasClosedByRemote = true;
+                    return bytesRead;
+                }
+                else
+                {
+                    // We got some more data, so can continue trying to fill the output buffer
+                    _receivedDataNotYetUsed = new ArraySegment<byte>(nextReceivedBlock, 0, nextReceivedBlock.Length);
+                }
+            }
+        }
+
+        public override Task WriteAsync(byte[] buffer, int offset, int count, CancellationToken cancellationToken)
+        {
+            if (_wasClosedByRemote)
+            {
+                throw new InvalidOperationException("The connection was already closed by the remote party");
+            }
+
+            return count > 0 ? _host.WriteAsync(Id, buffer, offset, count, cancellationToken) : CompletedTask;
+        }
+
+        public override int Read(byte[] buffer, int offset, int count)
+        {
+            return ReadAsync(buffer, offset, count, CancellationToken.None).Result;
+        }
+
+        public override long Seek(long offset, SeekOrigin origin)
+        {
+            throw new NotImplementedException();
+        }
+
+        public override void SetLength(long value)
+        {
+            throw new NotImplementedException();
+        }
+
+        public override void Write(byte[] buffer, int offset, int count)
+        {
+            WriteAsync(buffer, offset, count, CancellationToken.None).Wait();
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing && !_isDisposed)
+            {
+                _isDisposed = true;
+                _host.CloseInnerStream(Id, _wasClosedByRemote);
+            }
+        }
+
+        public async Task AddDataToQueue(byte[] data)
+        {
+            await _receivedDataQueue.SendAsync(data);
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/VirtualConnections/VirtualConnectionClient.cs

@@ -0,0 +1,238 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections
+{
+    /// <summary>
+    /// A callback that will be invoked if the <see cref="VirtualConnectionClient"/> encounters a read error.
+    /// </summary>
+    /// <param name="ex"></param>
+    public delegate void VirtualConnectionReadErrorHandler(Exception ex);
+
+    /// <summary>
+    /// Wraps an underlying physical read/write stream (e.g., named pipes, domain sockets, or TCP sockets) and
+    /// exposes an API for making 'virtual connections', which act as independent read/write streams.
+    /// Traffic over these virtual connections is multiplexed over the underlying physical stream. This is useful
+    /// for fast stream-based inter-process communication because it avoids the overhead of opening a new physical
+    /// connection each time a new communication channel is needed.
+    /// </summary>
+    internal class VirtualConnectionClient : IDisposable
+    {
+        internal const int MaxFrameBodyLength = 16 * 1024;
+
+        public event VirtualConnectionReadErrorHandler OnError;
+
+        private Stream _underlyingTransport;
+        private Dictionary<long, VirtualConnection> _activeInnerStreams;
+        private long _nextInnerStreamId;
+        private readonly SemaphoreSlim _streamWriterSemaphore = new SemaphoreSlim(1);
+        private readonly object _readControlLock = new object();
+        private Exception _readLoopExitedWithException;
+        private readonly CancellationTokenSource _disposalCancellatonToken = new CancellationTokenSource();
+        private bool _disposedValue = false;
+
+        public VirtualConnectionClient(Stream underlyingTransport)
+        {
+            _underlyingTransport = underlyingTransport;
+            _activeInnerStreams = new Dictionary<long, VirtualConnection>();
+
+            RunReadLoop();
+        }
+
+        public Stream OpenVirtualConnection()
+        {
+            // Improve discoverability of read-loop errors (in case the developer doesn't add an OnError listener)
+            ThrowIfReadLoopFailed();
+
+            var id = Interlocked.Increment(ref _nextInnerStreamId);
+            var newInnerStream = new VirtualConnection(id, this);
+            lock (_activeInnerStreams)
+            {
+                _activeInnerStreams.Add(id, newInnerStream);
+            }
+
+            return newInnerStream;
+        }
+
+        // It's async void because nothing waits for it to finish (it continues indefinitely). It signals any errors via
+        // a separate channel.
+        private async void RunReadLoop()
+        {
+            try
+            {
+                while (!_disposalCancellatonToken.IsCancellationRequested)
+                {
+                    var remoteIsStillConnected = await ProcessNextFrameAsync();
+                    if (!remoteIsStillConnected)
+                    {
+                        CloseAllActiveStreams();
+                    }
+                }
+            }
+            catch (Exception ex)
+            {
+                // Not all underlying transports correctly honor cancellation tokens. For example,
+                // DomainSocketStreamTransport's ReadAsync ignores them, so we only know to stop
+                // the read loop when the underlying stream is disposed and then it throws ObjectDisposedException.
+                if (!(ex is TaskCanceledException || ex is ObjectDisposedException))
+                {
+                    _readLoopExitedWithException = ex;
+
+                    var evt = OnError;
+                    if (evt != null)
+                    {
+                        evt(ex);
+                    }
+                }
+            }
+        }
+
+        private async Task<bool> ProcessNextFrameAsync()
+        {
+            // First read frame header
+            var frameHeaderBuffer = await ReadExactLength(12);
+            if (frameHeaderBuffer == null)
+            {
+                return false; // Underlying stream was closed
+            }
+
+            // Parse frame header, then read the frame body
+            long streamId = BitConverter.ToInt64(frameHeaderBuffer, 0);
+            int frameBodyLength = BitConverter.ToInt32(frameHeaderBuffer, 8);
+            if (frameBodyLength < 0 || frameBodyLength > MaxFrameBodyLength)
+            {
+                throw new InvalidDataException("Illegal frame length: " + frameBodyLength);
+            }
+
+            var frameBody = await ReadExactLength(frameBodyLength);
+            if (frameBody == null)
+            {
+                return false; // Underlying stream was closed
+            }
+
+            // Dispatch the frame to the relevant inner stream
+            VirtualConnection innerStream;
+            lock (_activeInnerStreams)
+            {
+                _activeInnerStreams.TryGetValue(streamId, out innerStream);
+            }
+
+            if (innerStream != null)
+            {
+                await innerStream.AddDataToQueue(frameBody);
+            }
+
+            return true;
+        }
+
+        private async Task<byte[]> ReadExactLength(int lengthToRead) {
+            byte[] buffer = new byte[lengthToRead];
+            var totalBytesRead = 0;
+            var ct = _disposalCancellatonToken.Token;
+            while (totalBytesRead < lengthToRead)
+            {
+                var chunkLengthRead = await _underlyingTransport.ReadAsync(buffer, totalBytesRead, lengthToRead - totalBytesRead, ct);
+                if (chunkLengthRead == 0)
+                {
+                    // Underlying stream was closed
+                    return null;
+                }
+
+                totalBytesRead += chunkLengthRead;
+            }
+
+            return buffer;
+        }
+
+        private void CloseAllActiveStreams()
+        {
+            IList<VirtualConnection> innerStreamsCopy;
+
+            // Only hold the lock while cloning the list of inner streams. Release the lock before
+            // actually disposing them, because each 'dispose' call will try to take another lock
+            // so it can remove that inner stream from activeInnerStreams.
+            lock (_activeInnerStreams)
+            {
+                innerStreamsCopy = _activeInnerStreams.Values.ToList();
+            }
+
+            foreach (var stream in innerStreamsCopy)
+            {
+                stream.Dispose();
+            }
+        }
+
+        public void Dispose()
+        {
+            if (!_disposedValue)
+            {
+                _disposedValue = true;
+
+                _disposalCancellatonToken.Cancel(); // Stops the read loop
+                CloseAllActiveStreams();
+            }
+        }
+
+        public async Task WriteAsync(long innerStreamId, byte[] data, int offset, int count, CancellationToken cancellationToken)
+        {
+            // In case the amount of data to be sent exceeds the max frame length, split it into separate frames
+            // Note that we always send at least one frame, even if it's empty, because the zero-length frame is the signal to close a virtual connection
+            // (hence 'do..while' instead of just 'while').
+            int bytesWritten = 0;
+            do {
+                // Improve discoverability of read-loop errors (in case the developer doesn't add an OnError listener)
+                ThrowIfReadLoopFailed();
+
+                // Hold the write lock only for the time taken to send a single frame, not all frames, to allow large sends to be proceed in parallel
+                await _streamWriterSemaphore.WaitAsync(cancellationToken).ConfigureAwait(false);
+                try
+                {
+                    // Write stream ID, then length prefix, then chunk payload, then flush
+                    var nextChunkBodyLength = Math.Min(MaxFrameBodyLength, count - bytesWritten);
+                    await _underlyingTransport.WriteAsync(BitConverter.GetBytes(innerStreamId), 0, 8, cancellationToken).ConfigureAwait(false);
+                    await _underlyingTransport.WriteAsync(BitConverter.GetBytes(nextChunkBodyLength), 0, 4, cancellationToken).ConfigureAwait(false);
+
+                    if (nextChunkBodyLength > 0)
+                    {
+                        await _underlyingTransport.WriteAsync(data, offset + bytesWritten, nextChunkBodyLength, cancellationToken).ConfigureAwait(false);
+                        bytesWritten += nextChunkBodyLength;
+                    }
+
+                    await _underlyingTransport.FlushAsync(cancellationToken).ConfigureAwait(false);
+                }
+                finally
+                {
+                    _streamWriterSemaphore.Release();
+                }
+            } while (bytesWritten < count);
+        }
+
+        public void CloseInnerStream(long innerStreamId, bool isAlreadyClosedRemotely)
+        {
+            lock (_activeInnerStreams)
+            {
+                if (_activeInnerStreams.ContainsKey(innerStreamId))
+                {
+                    _activeInnerStreams.Remove(innerStreamId);
+                }
+            }
+
+            if (!isAlreadyClosedRemotely) {
+                // Also notify the remote that this innerstream is closed
+                WriteAsync(innerStreamId, new byte[0], 0, 0, new CancellationToken()).Wait();
+            }
+        }
+
+        private void ThrowIfReadLoopFailed()
+        {
+            if (_readLoopExitedWithException != null)
+            {
+                throw new AggregateException("The connection failed - see InnerException for details.", _readLoopExitedWithException);
+            }
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/baseline.netcore.json

@@ -0,0 +1,109 @@
+{
+  "AssemblyIdentity": "Microsoft.AspNetCore.NodeServices.Sockets, Version=2.1.1.0, Culture=neutral, PublicKeyToken=adb9793829ddae60",
+  "Types": [
+    {
+      "Name": "Microsoft.AspNetCore.NodeServices.Sockets.NodeServicesOptionsExtensions",
+      "Visibility": "Public",
+      "Kind": "Class",
+      "Abstract": true,
+      "Static": true,
+      "Sealed": true,
+      "ImplementedInterfaces": [],
+      "Members": [
+        {
+          "Kind": "Method",
+          "Name": "UseSocketHosting",
+          "Parameters": [
+            {
+              "Name": "options",
+              "Type": "Microsoft.AspNetCore.NodeServices.NodeServicesOptions"
+            }
+          ],
+          "ReturnType": "System.Void",
+          "Static": true,
+          "Extension": true,
+          "Visibility": "Public",
+          "GenericParameter": []
+        }
+      ],
+      "GenericParameters": []
+    },
+    {
+      "Name": "Microsoft.AspNetCore.NodeServices.Sockets.VirtualConnections.VirtualConnectionReadErrorHandler",
+      "Visibility": "Public",
+      "Kind": "Class",
+      "Sealed": true,
+      "BaseType": "System.MulticastDelegate",
+      "ImplementedInterfaces": [],
+      "Members": [
+        {
+          "Kind": "Method",
+          "Name": "Invoke",
+          "Parameters": [
+            {
+              "Name": "ex",
+              "Type": "System.Exception"
+            }
+          ],
+          "ReturnType": "System.Void",
+          "Virtual": true,
+          "Visibility": "Public",
+          "GenericParameter": []
+        },
+        {
+          "Kind": "Method",
+          "Name": "BeginInvoke",
+          "Parameters": [
+            {
+              "Name": "ex",
+              "Type": "System.Exception"
+            },
+            {
+              "Name": "callback",
+              "Type": "System.AsyncCallback"
+            },
+            {
+              "Name": "object",
+              "Type": "System.Object"
+            }
+          ],
+          "ReturnType": "System.IAsyncResult",
+          "Virtual": true,
+          "Visibility": "Public",
+          "GenericParameter": []
+        },
+        {
+          "Kind": "Method",
+          "Name": "EndInvoke",
+          "Parameters": [
+            {
+              "Name": "result",
+              "Type": "System.IAsyncResult"
+            }
+          ],
+          "ReturnType": "System.Void",
+          "Virtual": true,
+          "Visibility": "Public",
+          "GenericParameter": []
+        },
+        {
+          "Kind": "Constructor",
+          "Name": ".ctor",
+          "Parameters": [
+            {
+              "Name": "object",
+              "Type": "System.Object"
+            },
+            {
+              "Name": "method",
+              "Type": "System.IntPtr"
+            }
+          ],
+          "Visibility": "Public",
+          "GenericParameter": []
+        }
+      ],
+      "GenericParameters": []
+    }
+  ]
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/package.json

@@ -0,0 +1,19 @@
+{
+  "name": "nodeservices.sockets",
+  "version": "1.0.0",
+  "description": "This is not really an NPM package and will not be published. This file exists only to reference compilation tools.",
+  "main": "index.js",
+  "scripts": {
+    "test": "echo \"Error: no test specified\" && exit 1",
+    "build": "webpack --mode production"
+  },
+  "author": "Microsoft",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@types/node": "^10.9.2",
+    "ts-loader": "^4.5.0",
+    "typescript": "^3.0.1",
+    "webpack": "^4.17.1",
+    "webpack-cli": "^3.1.0"
+  }
+}

src/Microsoft.AspNetCore.NodeServices.Sockets/webpack.config.js

@@ -0,0 +1,24 @@
+const path = require('path');
+
+module.exports = {
+    target: 'node',
+    resolve: {
+        extensions: [ '.ts' ]
+    },
+    module: {
+        rules: [
+            { test: /\.ts$/, use: 'ts-loader' },
+        ]
+    },
+    entry: {
+        'entrypoint-socket': ['./TypeScript/SocketNodeInstanceEntryPoint'],
+    },
+    output: {
+        libraryTarget: 'commonjs',
+        path: path.join(__dirname, 'Content', 'Node'),
+        filename: '[name].js'
+    },
+    optimization: {
+        minimize: false
+    }
+};

src/Microsoft.AspNetCore.NodeServices/.gitignore

@@ -0,0 +1,3 @@
+/bin/
+/node_modules/
+yarn.lock

src/Microsoft.AspNetCore.NodeServices/Configuration/NodeServicesFactory.cs

@@ -0,0 +1,25 @@
+using System;
+
+namespace Microsoft.AspNetCore.NodeServices
+{
+    /// <summary>
+    /// Supplies INodeServices instances.
+    /// </summary>
+    public static class NodeServicesFactory
+    {
+        /// <summary>
+        /// Create an <see cref="INodeServices"/> instance according to the supplied options.
+        /// </summary>
+        /// <param name="options">Options for creating the <see cref="INodeServices"/> instance.</param>
+        /// <returns>An <see cref="INodeServices"/> instance.</returns>
+        public static INodeServices CreateNodeServices(NodeServicesOptions options)
+        {
+            if (options == null)
+            {
+                throw new ArgumentNullException(nameof (options));
+            }
+
+            return new NodeServicesImpl(options.NodeInstanceFactory);
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/Configuration/NodeServicesOptions.cs

@@ -0,0 +1,113 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Threading;
+using Microsoft.AspNetCore.NodeServices.HostingModels;
+using Microsoft.Extensions.Logging;
+using Microsoft.Extensions.DependencyInjection;
+using Microsoft.AspNetCore.Hosting;
+using Microsoft.Extensions.Logging.Abstractions;
+
+namespace Microsoft.AspNetCore.NodeServices
+{
+    /// <summary>
+    /// Describes options used to configure an <see cref="INodeServices"/> instance.
+    /// </summary>
+    public class NodeServicesOptions
+    {
+        internal const string TimeoutConfigPropertyName = nameof(InvocationTimeoutMilliseconds);
+        private const int DefaultInvocationTimeoutMilliseconds = 60 * 1000;
+        private const string LogCategoryName = "Microsoft.AspNetCore.NodeServices";
+        private static readonly string[] DefaultWatchFileExtensions = { ".js", ".jsx", ".ts", ".tsx", ".json", ".html" };
+
+        /// <summary>
+        /// Creates a new instance of <see cref="NodeServicesOptions"/>.
+        /// </summary>
+        /// <param name="serviceProvider">The <see cref="IServiceProvider"/>.</param>
+        public NodeServicesOptions(IServiceProvider serviceProvider)
+        {
+            if (serviceProvider == null)
+            {
+                throw new ArgumentNullException(nameof (serviceProvider));
+            }
+
+            EnvironmentVariables = new Dictionary<string, string>();
+            InvocationTimeoutMilliseconds = DefaultInvocationTimeoutMilliseconds;
+            WatchFileExtensions = (string[])DefaultWatchFileExtensions.Clone();
+
+            var hostEnv = serviceProvider.GetService<IHostingEnvironment>();
+            if (hostEnv != null)
+            {
+                // In an ASP.NET environment, we can use the IHostingEnvironment data to auto-populate a few
+                // things that you'd otherwise have to specify manually
+                ProjectPath = hostEnv.ContentRootPath;
+                EnvironmentVariables["NODE_ENV"] = hostEnv.IsDevelopment() ? "development" : "production"; // De-facto standard values for Node
+            }
+            else
+            {
+                ProjectPath = Directory.GetCurrentDirectory();
+            }
+
+            var applicationLifetime = serviceProvider.GetService<IApplicationLifetime>();
+            if (applicationLifetime != null)
+            {
+                ApplicationStoppingToken = applicationLifetime.ApplicationStopping;
+            }
+
+            // If the DI system gives us a logger, use it. Otherwise, set up a default one.
+            var loggerFactory = serviceProvider.GetService<ILoggerFactory>();
+            NodeInstanceOutputLogger = loggerFactory != null
+                ? loggerFactory.CreateLogger(LogCategoryName)
+                : NullLogger.Instance;
+            // By default, we use this package's built-in out-of-process-via-HTTP hosting/transport
+            this.UseHttpHosting();
+        }
+
+        /// <summary>
+        /// Specifies how to construct Node.js instances. An <see cref="INodeInstance"/> encapsulates all details about
+        /// how Node.js instances are launched and communicated with. A new <see cref="INodeInstance"/> will be created
+        /// automatically if the previous instance has terminated (e.g., because a source file changed).
+        /// </summary>
+        public Func<INodeInstance> NodeInstanceFactory { get; set; }
+
+        /// <summary>
+        /// If set, overrides the path to the root of your application. This path is used when locating Node.js modules relative to your project.
+        /// </summary>
+        public string ProjectPath { get; set; }
+
+        /// <summary>
+        /// If set, the Node.js instance should restart when any matching file on disk within your project changes.
+        /// </summary>
+        public string[] WatchFileExtensions { get; set; }
+
+        /// <summary>
+        /// The Node.js instance's stdout/stderr will be redirected to this <see cref="ILogger"/>.
+        /// </summary>
+        public ILogger NodeInstanceOutputLogger { get; set; }
+
+        /// <summary>
+        /// If true, the Node.js instance will accept incoming V8 debugger connections (e.g., from node-inspector).
+        /// </summary>
+        public bool LaunchWithDebugging { get; set; }
+
+        /// <summary>
+        /// If <see cref="LaunchWithDebugging"/> is true, the Node.js instance will listen for V8 debugger connections on this port.
+        /// </summary>
+        public int DebuggingPort { get; set; }
+
+        /// <summary>
+        /// If set, starts the Node.js instance with the specified environment variables.
+        /// </summary>
+        public IDictionary<string, string> EnvironmentVariables { get; set; }
+
+        /// <summary>
+        /// Specifies the maximum duration, in milliseconds, that your .NET code should wait for Node.js RPC calls to return.
+        /// </summary>
+        public int InvocationTimeoutMilliseconds { get; set; }
+
+        /// <summary>
+        /// A token that indicates when the host application is stopping.
+        /// </summary>
+        public CancellationToken ApplicationStoppingToken { get; set; }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/Configuration/NodeServicesServiceCollectionExtensions.cs

@@ -0,0 +1,41 @@
+using System;
+using Microsoft.AspNetCore.NodeServices;
+
+namespace Microsoft.Extensions.DependencyInjection
+{
+    /// <summary>
+    /// Extension methods for setting up NodeServices in an <see cref="IServiceCollection" />.
+    /// </summary>
+    public static class NodeServicesServiceCollectionExtensions
+    {
+        /// <summary>
+        /// Adds NodeServices support to the <paramref name="serviceCollection"/>.
+        /// </summary>
+        /// <param name="serviceCollection">The <see cref="IServiceCollection"/>.</param>
+        public static void AddNodeServices(this IServiceCollection serviceCollection)
+            => AddNodeServices(serviceCollection, _ => {});
+
+        /// <summary>
+        /// Adds NodeServices support to the <paramref name="serviceCollection"/>.
+        /// </summary>
+        /// <param name="serviceCollection">The <see cref="IServiceCollection"/>.</param>
+        /// <param name="setupAction">A callback that will be invoked to populate the <see cref="NodeServicesOptions"/>.</param>
+        public static void AddNodeServices(this IServiceCollection serviceCollection, Action<NodeServicesOptions> setupAction)
+        {
+            if (setupAction == null)
+            {
+                throw new ArgumentNullException(nameof (setupAction));
+            }
+
+            serviceCollection.AddSingleton(typeof(INodeServices), serviceProvider =>
+            {
+                // First we let NodeServicesOptions take its defaults from the IServiceProvider,
+                // then we let the developer override those options
+                var options = new NodeServicesOptions(serviceProvider);
+                setupAction(options);
+
+                return NodeServicesFactory.CreateNodeServices(options);
+            });
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/Content/Node/entrypoint-http.js

@@ -0,0 +1,416 @@
+(function(e, a) { for(var i in a) e[i] = a[i]; }(exports, /******/ (function(modules) { // webpackBootstrap
+/******/ 	// The module cache
+/******/ 	var installedModules = {};
+/******/
+/******/ 	// The require function
+/******/ 	function __webpack_require__(moduleId) {
+/******/
+/******/ 		// Check if module is in cache
+/******/ 		if(installedModules[moduleId]) {
+/******/ 			return installedModules[moduleId].exports;
+/******/ 		}
+/******/ 		// Create a new module (and put it into the cache)
+/******/ 		var module = installedModules[moduleId] = {
+/******/ 			i: moduleId,
+/******/ 			l: false,
+/******/ 			exports: {}
+/******/ 		};
+/******/
+/******/ 		// Execute the module function
+/******/ 		modules[moduleId].call(module.exports, module, module.exports, __webpack_require__);
+/******/
+/******/ 		// Flag the module as loaded
+/******/ 		module.l = true;
+/******/
+/******/ 		// Return the exports of the module
+/******/ 		return module.exports;
+/******/ 	}
+/******/
+/******/
+/******/ 	// expose the modules object (__webpack_modules__)
+/******/ 	__webpack_require__.m = modules;
+/******/
+/******/ 	// expose the module cache
+/******/ 	__webpack_require__.c = installedModules;
+/******/
+/******/ 	// define getter function for harmony exports
+/******/ 	__webpack_require__.d = function(exports, name, getter) {
+/******/ 		if(!__webpack_require__.o(exports, name)) {
+/******/ 			Object.defineProperty(exports, name, { enumerable: true, get: getter });
+/******/ 		}
+/******/ 	};
+/******/
+/******/ 	// define __esModule on exports
+/******/ 	__webpack_require__.r = function(exports) {
+/******/ 		if(typeof Symbol !== 'undefined' && Symbol.toStringTag) {
+/******/ 			Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+/******/ 		}
+/******/ 		Object.defineProperty(exports, '__esModule', { value: true });
+/******/ 	};
+/******/
+/******/ 	// create a fake namespace object
+/******/ 	// mode & 1: value is a module id, require it
+/******/ 	// mode & 2: merge all properties of value into the ns
+/******/ 	// mode & 4: return value when already ns object
+/******/ 	// mode & 8|1: behave like require
+/******/ 	__webpack_require__.t = function(value, mode) {
+/******/ 		if(mode & 1) value = __webpack_require__(value);
+/******/ 		if(mode & 8) return value;
+/******/ 		if((mode & 4) && typeof value === 'object' && value && value.__esModule) return value;
+/******/ 		var ns = Object.create(null);
+/******/ 		__webpack_require__.r(ns);
+/******/ 		Object.defineProperty(ns, 'default', { enumerable: true, value: value });
+/******/ 		if(mode & 2 && typeof value != 'string') for(var key in value) __webpack_require__.d(ns, key, function(key) { return value[key]; }.bind(null, key));
+/******/ 		return ns;
+/******/ 	};
+/******/
+/******/ 	// getDefaultExport function for compatibility with non-harmony modules
+/******/ 	__webpack_require__.n = function(module) {
+/******/ 		var getter = module && module.__esModule ?
+/******/ 			function getDefault() { return module['default']; } :
+/******/ 			function getModuleExports() { return module; };
+/******/ 		__webpack_require__.d(getter, 'a', getter);
+/******/ 		return getter;
+/******/ 	};
+/******/
+/******/ 	// Object.prototype.hasOwnProperty.call
+/******/ 	__webpack_require__.o = function(object, property) { return Object.prototype.hasOwnProperty.call(object, property); };
+/******/
+/******/ 	// __webpack_public_path__
+/******/ 	__webpack_require__.p = "";
+/******/
+/******/
+/******/ 	// Load entry module and return exports
+/******/ 	return __webpack_require__(__webpack_require__.s = 1);
+/******/ })
+/************************************************************************/
+/******/ ([
+/* 0 */
+/***/ (function(module, exports) {
+
+module.exports = require("path");
+
+/***/ }),
+/* 1 */
+/***/ (function(module, exports, __webpack_require__) {
+
+module.exports = __webpack_require__(2);
+
+
+/***/ }),
+/* 2 */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+exports.__esModule = true;
+// Limit dependencies to core Node modules. This means the code in this file has to be very low-level and unattractive,
+// but simplifies things for the consumer of this module.
+__webpack_require__(3);
+__webpack_require__(4);
+var http = __webpack_require__(5);
+var path = __webpack_require__(0);
+var ArgsUtil_1 = __webpack_require__(6);
+var ExitWhenParentExits_1 = __webpack_require__(7);
+// Webpack doesn't support dynamic requires for files not present at compile time, so grab a direct
+// reference to Node's runtime 'require' function.
+var dynamicRequire = eval('require');
+var server = http.createServer(function (req, res) {
+    readRequestBodyAsJson(req, function (bodyJson) {
+        var hasSentResult = false;
+        var callback = function (errorValue, successValue) {
+            if (!hasSentResult) {
+                hasSentResult = true;
+                if (errorValue) {
+                    respondWithError(res, errorValue);
+                }
+                else if (typeof successValue !== 'string') {
+                    // Arbitrary object/number/etc - JSON-serialize it
+                    var successValueJson = void 0;
+                    try {
+                        successValueJson = JSON.stringify(successValue);
+                    }
+                    catch (ex) {
+                        // JSON serialization error - pass it back to .NET
+                        respondWithError(res, ex);
+                        return;
+                    }
+                    res.setHeader('Content-Type', 'application/json');
+                    res.end(successValueJson);
+                }
+                else {
+                    // String - can bypass JSON-serialization altogether
+                    res.setHeader('Content-Type', 'text/plain');
+                    res.end(successValue);
+                }
+            }
+        };
+        // Support streamed responses
+        Object.defineProperty(callback, 'stream', {
+            enumerable: true,
+            get: function () {
+                if (!hasSentResult) {
+                    hasSentResult = true;
+                    res.setHeader('Content-Type', 'application/octet-stream');
+                }
+                return res;
+            }
+        });
+        try {
+            var resolvedPath = path.resolve(process.cwd(), bodyJson.moduleName);
+            var invokedModule = dynamicRequire(resolvedPath);
+            var func = bodyJson.exportedFunctionName ? invokedModule[bodyJson.exportedFunctionName] : invokedModule;
+            if (!func) {
+                throw new Error('The module "' + resolvedPath + '" has no export named "' + bodyJson.exportedFunctionName + '"');
+            }
+            func.apply(null, [callback].concat(bodyJson.args));
+        }
+        catch (synchronousException) {
+            callback(synchronousException, null);
+        }
+    });
+});
+var parsedArgs = ArgsUtil_1.parseArgs(process.argv);
+var requestedPortOrZero = parsedArgs.port || 0; // 0 means 'let the OS decide'
+server.listen(requestedPortOrZero, 'localhost', function () {
+    var addressInfo = server.address();
+    // Signal to HttpNodeHost which loopback IP address (IPv4 or IPv6) and port it should make its HTTP connections on
+    console.log('[Microsoft.AspNetCore.NodeServices.HttpNodeHost:Listening on {' + addressInfo.address + '} port ' + addressInfo.port + '\]');
+    // Signal to the NodeServices base class that we're ready to accept invocations
+    console.log('[Microsoft.AspNetCore.NodeServices:Listening]');
+});
+ExitWhenParentExits_1.exitWhenParentExits(parseInt(parsedArgs.parentPid), /* ignoreSigint */ true);
+function readRequestBodyAsJson(request, callback) {
+    var requestBodyAsString = '';
+    request.on('data', function (chunk) { requestBodyAsString += chunk; });
+    request.on('end', function () { callback(JSON.parse(requestBodyAsString)); });
+}
+function respondWithError(res, errorValue) {
+    res.statusCode = 500;
+    res.end(JSON.stringify({
+        errorMessage: errorValue.message || errorValue,
+        errorDetails: errorValue.stack || null
+    }));
+}
+
+
+/***/ }),
+/* 3 */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+exports.__esModule = true;
+var path = __webpack_require__(0);
+var startsWith = function (str, prefix) { return str.substring(0, prefix.length) === prefix; };
+var appRootDir = process.cwd();
+function patchedLStat(pathToStatLong, fsReqWrap) {
+    try {
+        // If the lstat completes without errors, we don't modify its behavior at all
+        return origLStat.apply(this, arguments);
+    }
+    catch (ex) {
+        var shouldOverrideError = startsWith(ex.message, 'EPERM') // It's a permissions error
+            && typeof appRootDirLong === 'string'
+            && startsWith(appRootDirLong, pathToStatLong) // ... for an ancestor directory
+            && ex.stack.indexOf('Object.realpathSync ') >= 0; // ... during symlink resolution
+        if (shouldOverrideError) {
+            // Fake the result to give the same result as an 'lstat' on the app root dir.
+            // This stops Node failing to load modules just because it doesn't know whether
+            // ancestor directories are symlinks or not. If there's a genuine file
+            // permissions issue, it will still surface later when Node actually
+            // tries to read the file.
+            return origLStat.call(this, appRootDir, fsReqWrap);
+        }
+        else {
+            // In any other case, preserve the original error
+            throw ex;
+        }
+    }
+}
+;
+// It's only necessary to apply this workaround on Windows
+var appRootDirLong = null;
+var origLStat = null;
+if (/^win/.test(process.platform)) {
+    try {
+        // Get the app's root dir in Node's internal "long" format (e.g., \\?\C:\dir\subdir)
+        appRootDirLong = path._makeLong(appRootDir);
+        // Actually apply the patch, being as defensive as possible
+        var bindingFs = process.binding('fs');
+        origLStat = bindingFs.lstat;
+        if (typeof origLStat === 'function') {
+            bindingFs.lstat = patchedLStat;
+        }
+    }
+    catch (ex) {
+        // If some future version of Node throws (e.g., to prevent use of process.binding()),
+        // don't apply the patch, but still let the application run.
+    }
+}
+
+
+/***/ }),
+/* 4 */
+/***/ (function(module, exports) {
+
+// When Node writes to stdout/strerr, we capture that and convert the lines into calls on the
+// active .NET ILogger. But by default, stdout/stderr don't have any way of distinguishing
+// linebreaks inside log messages from the linebreaks that delimit separate log messages,
+// so multiline strings will end up being written to the ILogger as multiple independent
+// log messages. This makes them very hard to make sense of, especially when they represent
+// something like stack traces.
+//
+// To fix this, we intercept stdout/stderr writes, and replace internal linebreaks with a
+// marker token. When .NET receives the lines, it converts the marker tokens back to regular
+// linebreaks within the logged messages.
+//
+// Note that it's better to do the interception at the stdout/stderr level, rather than at
+// the console.log/console.error (etc.) level, because this takes place after any native
+// message formatting has taken place (e.g., inserting values for % placeholders).
+var findInternalNewlinesRegex = /\n(?!$)/g;
+var encodedNewline = '__ns_newline__';
+encodeNewlinesWrittenToStream(process.stdout);
+encodeNewlinesWrittenToStream(process.stderr);
+function encodeNewlinesWrittenToStream(outputStream) {
+    var origWriteFunction = outputStream.write;
+    outputStream.write = function (value) {
+        // Only interfere with the write if it's definitely a string
+        if (typeof value === 'string') {
+            var argsClone = Array.prototype.slice.call(arguments, 0);
+            argsClone[0] = encodeNewlinesInString(value);
+            origWriteFunction.apply(this, argsClone);
+        }
+        else {
+            origWriteFunction.apply(this, arguments);
+        }
+    };
+}
+function encodeNewlinesInString(str) {
+    return str.replace(findInternalNewlinesRegex, encodedNewline);
+}
+
+
+/***/ }),
+/* 5 */
+/***/ (function(module, exports) {
+
+module.exports = require("http");
+
+/***/ }),
+/* 6 */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+exports.__esModule = true;
+function parseArgs(args) {
+    // Very simplistic parsing which is sufficient for the cases needed. We don't want to bring in any external
+    // dependencies (such as an args-parsing library) to this file.
+    var result = {};
+    var currentKey = null;
+    args.forEach(function (arg) {
+        if (arg.indexOf('--') === 0) {
+            var argName = arg.substring(2);
+            result[argName] = undefined;
+            currentKey = argName;
+        }
+        else if (currentKey) {
+            result[currentKey] = arg;
+            currentKey = null;
+        }
+    });
+    return result;
+}
+exports.parseArgs = parseArgs;
+
+
+/***/ }),
+/* 7 */
+/***/ (function(module, exports, __webpack_require__) {
+
+"use strict";
+
+/*
+In general, we want the Node child processes to be terminated as soon as the parent .NET processes exit,
+because we have no further use for them. If the .NET process shuts down gracefully, it will run its
+finalizers, one of which (in OutOfProcessNodeInstance.cs) will kill its associated Node process immediately.
+
+But if the .NET process is terminated forcefully (e.g., on Linux/OSX with 'kill -9'), then it won't have
+any opportunity to shut down its child processes, and by default they will keep running. In this case, it's
+up to the child process to detect this has happened and terminate itself.
+
+There are many possible approaches to detecting when a parent process has exited, most of which behave
+differently between Windows and Linux/OS X:
+
+ - On Windows, the parent process can mark its child as being a 'job' that should auto-terminate when
+   the parent does (http://stackoverflow.com/a/4657392). Not cross-platform.
+ - The child Node process can get a callback when the parent disconnects (process.on('disconnect', ...)).
+   But despite http://stackoverflow.com/a/16487966, no callback fires in any case I've tested (Windows / OS X).
+ - The child Node process can get a callback when its stdin/stdout are disconnected, as described at
+   http://stackoverflow.com/a/15693934. This works well on OS X, but calling stdout.resume() on Windows
+   causes the process to terminate prematurely.
+ - I don't know why, but on Windows, it's enough to invoke process.stdin.resume(). For some reason this causes
+   the child Node process to exit as soon as the parent one does, but I don't see this documented anywhere.
+ - You can poll to see if the parent process, or your stdin/stdout connection to it, is gone
+   - You can directly pass a parent process PID to the child, and then have the child poll to see if it's
+     still running (e.g., using process.kill(pid, 0), which doesn't kill it but just tests whether it exists,
+     as per https://nodejs.org/api/process.html#process_process_kill_pid_signal)
+   - Or, on each poll, you can try writing to process.stdout. If the parent has died, then this will throw.
+     However I don't see this documented anywhere. It would be nice if you could just poll for whether or not
+     process.stdout is still connected (without actually writing to it) but I haven't found any property whose
+     value changes until you actually try to write to it.
+
+Of these, the only cross-platform approach that is actually documented as a valid strategy is simply polling
+to check whether the parent PID is still running. So that's what we do here.
+*/
+exports.__esModule = true;
+var pollIntervalMs = 1000;
+function exitWhenParentExits(parentPid, ignoreSigint) {
+    setInterval(function () {
+        if (!processExists(parentPid)) {
+            // Can't log anything at this point, because out stdout was connected to the parent,
+            // but the parent is gone.
+            process.exit();
+        }
+    }, pollIntervalMs);
+    if (ignoreSigint) {
+        // Pressing ctrl+c in the terminal sends a SIGINT to all processes in the foreground process tree.
+        // By default, the Node process would then exit before the .NET process, because ASP.NET implements
+        // a delayed shutdown to allow ongoing requests to complete.
+        //
+        // This is problematic, because if Node exits first, the CopyToAsync code in ConditionalProxyMiddleware
+        // will experience a read fault, and logs a huge load of errors. Fortunately, since the Node process is
+        // already set up to shut itself down if it detects the .NET process is terminated, all we have to do is
+        // ignore the SIGINT. The Node process will then terminate automatically after the .NET process does.
+        //
+        // A better solution would be to have WebpackDevMiddleware listen for SIGINT and gracefully close any
+        // ongoing EventSource connections before letting the Node process exit, independently of the .NET
+        // process exiting. However, doing this well in general is very nontrivial (see all the discussion at
+        // https://github.com/nodejs/node/issues/2642).
+        process.on('SIGINT', function () {
+            console.log('Received SIGINT. Waiting for .NET process to exit...');
+        });
+    }
+}
+exports.exitWhenParentExits = exitWhenParentExits;
+function processExists(pid) {
+    try {
+        // Sending signal 0 - on all platforms - tests whether the process exists. As long as it doesn't
+        // throw, that means it does exist.
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (ex) {
+        // If the reason for the error is that we don't have permission to ask about this process,
+        // report that as a separate problem.
+        if (ex.code === 'EPERM') {
+            throw new Error("Attempted to check whether process " + pid + " was running, but got a permissions error.");
+        }
+        return false;
+    }
+}
+
+
+/***/ })
+/******/ ])));

src/Microsoft.AspNetCore.NodeServices/HostingModels/HttpNodeInstance.cs

@@ -0,0 +1,157 @@
+using System;
+using System.IO;
+using System.Net.Http;
+using System.Text;
+using System.Text.RegularExpressions;
+using System.Threading;
+using System.Threading.Tasks;
+using Newtonsoft.Json;
+using Newtonsoft.Json.Serialization;
+
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// A specialisation of the OutOfProcessNodeInstance base class that uses HTTP to perform RPC invocations.
+    ///
+    /// The Node child process starts an HTTP listener on an arbitrary available port (except where a nonzero
+    /// port number is specified as a constructor parameter), and signals which port was selected using the same
+    /// input/output-based mechanism that the base class uses to determine when the child process is ready to
+    /// accept RPC invocations.
+    /// </summary>
+    /// <seealso cref="Microsoft.AspNetCore.NodeServices.HostingModels.OutOfProcessNodeInstance" />
+    internal class HttpNodeInstance : OutOfProcessNodeInstance
+    {
+        private static readonly Regex EndpointMessageRegex =
+            new Regex(@"^\[Microsoft.AspNetCore.NodeServices.HttpNodeHost:Listening on {(.*?)} port (\d+)\]$");
+
+        private static readonly JsonSerializerSettings jsonSerializerSettings = new JsonSerializerSettings
+        {
+            ContractResolver = new CamelCasePropertyNamesContractResolver(),
+            TypeNameHandling = TypeNameHandling.None
+        };
+
+        private readonly HttpClient _client;
+        private bool _disposed;
+        private string _endpoint;
+
+        public HttpNodeInstance(NodeServicesOptions options, int port = 0)
+        : base(
+                EmbeddedResourceReader.Read(
+                    typeof(HttpNodeInstance),
+                    "/Content/Node/entrypoint-http.js"),
+                options.ProjectPath,
+                options.WatchFileExtensions,
+                MakeCommandLineOptions(port),
+                options.ApplicationStoppingToken,
+                options.NodeInstanceOutputLogger,
+                options.EnvironmentVariables,
+                options.InvocationTimeoutMilliseconds,
+                options.LaunchWithDebugging,
+                options.DebuggingPort)
+        {
+            _client = new HttpClient();
+            _client.Timeout = TimeSpan.FromMilliseconds(options.InvocationTimeoutMilliseconds + 1000);
+        }
+
+        private static string MakeCommandLineOptions(int port)
+        {
+            return $"--port {port}";
+        }
+
+        protected override async Task<T> InvokeExportAsync<T>(
+            NodeInvocationInfo invocationInfo, CancellationToken cancellationToken)
+        {
+            var payloadJson = JsonConvert.SerializeObject(invocationInfo, jsonSerializerSettings);
+            var payload = new StringContent(payloadJson, Encoding.UTF8, "application/json");
+            var response = await _client.PostAsync(_endpoint, payload, cancellationToken);
+
+            if (!response.IsSuccessStatusCode)
+            {
+                // Unfortunately there's no true way to cancel ReadAsStringAsync calls, hence AbandonIfCancelled
+                var responseJson = await response.Content.ReadAsStringAsync().OrThrowOnCancellation(cancellationToken);
+                var responseError = JsonConvert.DeserializeObject<RpcJsonResponse>(responseJson, jsonSerializerSettings);
+
+                throw new NodeInvocationException(responseError.ErrorMessage, responseError.ErrorDetails);
+            }
+
+            var responseContentType = response.Content.Headers.ContentType;
+            switch (responseContentType.MediaType)
+            {
+                case "text/plain":
+                    // String responses can skip JSON encoding/decoding
+                    if (typeof(T) != typeof(string))
+                    {
+                        throw new ArgumentException(
+                            "Node module responded with non-JSON string. This cannot be converted to the requested generic type: " +
+                            typeof(T).FullName);
+                    }
+
+                    var responseString = await response.Content.ReadAsStringAsync().OrThrowOnCancellation(cancellationToken);
+                    return (T)(object)responseString;
+
+                case "application/json":
+                    var responseJson = await response.Content.ReadAsStringAsync().OrThrowOnCancellation(cancellationToken);
+                    return JsonConvert.DeserializeObject<T>(responseJson, jsonSerializerSettings);
+
+                case "application/octet-stream":
+                    // Streamed responses have to be received as System.IO.Stream instances
+                    if (typeof(T) != typeof(Stream) && typeof(T) != typeof(object))
+                    {
+                        throw new ArgumentException(
+                            "Node module responded with binary stream. This cannot be converted to the requested generic type: " +
+                            typeof(T).FullName + ". Instead you must use the generic type System.IO.Stream.");
+                    }
+
+                    return (T)(object)(await response.Content.ReadAsStreamAsync().OrThrowOnCancellation(cancellationToken));
+
+                default:
+                    throw new InvalidOperationException("Unexpected response content type: " + responseContentType.MediaType);
+            }
+        }
+
+        protected override void OnOutputDataReceived(string outputData)
+        {
+            // Watch for "port selected" messages, and when observed, 
+            // store the IP (IPv4/IPv6) and port number
+            // so we can use it when making HTTP requests. The child process will always send
+            // one of these messages before it sends a "ready for connections" message.
+            var match = string.IsNullOrEmpty(_endpoint) ? EndpointMessageRegex.Match(outputData) : null;
+            if (match != null && match.Success)
+            {
+                var port = int.Parse(match.Groups[2].Captures[0].Value);
+                var resolvedIpAddress = match.Groups[1].Captures[0].Value;
+
+                //IPv6 must be wrapped with [] brackets
+                resolvedIpAddress = resolvedIpAddress == "::1" ? $"[{resolvedIpAddress}]" : resolvedIpAddress;
+                _endpoint = $"http://{resolvedIpAddress}:{port}";
+            }
+            else
+            {
+                base.OnOutputDataReceived(outputData);
+            }
+        }
+
+        protected override void Dispose(bool disposing)
+        {
+            base.Dispose(disposing);
+
+            if (!_disposed)
+            {
+                if (disposing)
+                {
+                    _client.Dispose();
+                }
+
+                _disposed = true;
+            }
+        }
+
+#pragma warning disable 649 // These properties are populated via JSON deserialization
+        private class RpcJsonResponse
+        {
+            public string ErrorMessage { get; set; }
+            public string ErrorDetails { get; set; }
+        }
+#pragma warning restore 649
+    }
+}

src/Microsoft.AspNetCore.NodeServices/HostingModels/INodeInstance.cs

@@ -0,0 +1,23 @@
+using System;
+using System.Threading;
+using System.Threading.Tasks;
+
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// Represents an instance of Node.js to which Remote Procedure Calls (RPC) may be sent.
+    /// </summary>
+    public interface INodeInstance : IDisposable
+    {
+        /// <summary>
+        /// Asynchronously invokes code in the Node.js instance.
+        /// </summary>
+        /// <typeparam name="T">The JSON-serializable data type that the Node.js code will asynchronously return.</typeparam>
+        /// <param name="cancellationToken">A <see cref="CancellationToken"/> that can be used to cancel the invocation.</param>
+        /// <param name="moduleName">The path to the Node.js module (i.e., JavaScript file) relative to your project root that contains the code to be invoked.</param>
+        /// <param name="exportNameOrNull">If set, specifies the CommonJS export to be invoked. If not set, the module's default CommonJS export itself must be a function to be invoked.</param>
+        /// <param name="args">Any sequence of JSON-serializable arguments to be passed to the Node.js function.</param>
+        /// <returns>A <see cref="Task{TResult}"/> representing the completion of the RPC call.</returns>
+        Task<T> InvokeExportAsync<T>(CancellationToken cancellationToken, string moduleName, string exportNameOrNull, params object[] args);
+    }
+}

src/Microsoft.AspNetCore.NodeServices/HostingModels/NodeInvocationException.cs

@@ -0,0 +1,55 @@
+using System;
+
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// Represents an exception caused by invoking Node.js code.
+    /// </summary>
+    public class NodeInvocationException : Exception
+    {
+        /// <summary>
+        /// If true, indicates that the invocation failed because the Node.js instance could not be reached. For example,
+        /// it might have already shut down or previously crashed.
+        /// </summary>
+        public bool NodeInstanceUnavailable { get; private set; }
+
+        /// <summary>
+        /// If true, indicates that even though the invocation failed because the Node.js instance could not be reached
+        /// or needs to be restarted, that Node.js instance may remain alive for a period in order to complete any
+        /// outstanding requests.
+        /// </summary>
+        public bool AllowConnectionDraining { get; private set;}
+
+        /// <summary>
+        /// Creates a new instance of <see cref="NodeInvocationException"/>.
+        /// </summary>
+        /// <param name="message">A description of the exception.</param>
+        /// <param name="details">Additional information, such as a Node.js stack trace, representing the exception.</param>
+        public NodeInvocationException(string message, string details)
+            : base(message + Environment.NewLine + details)
+        {
+        }
+
+        /// <summary>
+        /// Creates a new instance of <see cref="NodeInvocationException"/>.
+        /// </summary>
+        /// <param name="message">A description of the exception.</param>
+        /// <param name="details">Additional information, such as a Node.js stack trace, representing the exception.</param>
+        /// <param name="nodeInstanceUnavailable">Specifies a value for the <see cref="NodeInstanceUnavailable"/> flag.</param>
+        /// <param name="allowConnectionDraining">Specifies a value for the <see cref="AllowConnectionDraining"/> flag.</param>
+        public NodeInvocationException(string message, string details, bool nodeInstanceUnavailable, bool allowConnectionDraining)
+            : this(message, details)
+        {
+            // Reject a meaningless combination of flags
+            if (allowConnectionDraining && !nodeInstanceUnavailable)
+            {
+                throw new ArgumentException(
+                    $"The '${ nameof(allowConnectionDraining) }' parameter cannot be true " +
+                    $"unless the '${ nameof(nodeInstanceUnavailable) }' parameter is also true.");
+            }
+
+            NodeInstanceUnavailable = nodeInstanceUnavailable;
+            AllowConnectionDraining = allowConnectionDraining;
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/HostingModels/NodeInvocationInfo.cs

@@ -0,0 +1,24 @@
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// Describes an RPC call sent from .NET code to Node.js code.
+    /// </summary>
+    public class NodeInvocationInfo
+    {
+        /// <summary>
+        /// Specifies the path to the Node.js module (i.e., .js file) relative to the project root.
+        /// </summary>
+        public string ModuleName { get; set; }
+
+        /// <summary>
+        /// If set, specifies the name of CommonJS function export to be invoked.
+        /// If not set, the Node.js module's default export must itself be a function to be invoked.
+        /// </summary>
+        public string ExportedFunctionName { get; set; }
+
+        /// <summary>
+        /// A sequence of JSON-serializable arguments to be passed to the Node.js function being invoked.
+        /// </summary>
+        public object[] Args { get; set; }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/HostingModels/NodeServicesOptionsExtensions.cs

@@ -0,0 +1,17 @@
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// Extension methods that help with populating a <see cref="NodeServicesOptions"/> object.
+    /// </summary>
+    public static class NodeServicesOptionsExtensions
+    {
+        /// <summary>
+        /// Configures the <see cref="INodeServices"/> service so that it will use out-of-process
+        /// Node.js instances and perform RPC calls over HTTP.
+        /// </summary>
+        public static void UseHttpHosting(this NodeServicesOptions options)
+        {
+            options.NodeInstanceFactory = () => new HttpNodeInstance(options);
+        }
+    }
+}

src/Microsoft.AspNetCore.NodeServices/HostingModels/OutOfProcessNodeInstance.cs

@@ -0,0 +1,475 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.IO;
+using System.Linq;
+using System.Threading;
+using System.Threading.Tasks;
+using Microsoft.Extensions.Logging;
+
+namespace Microsoft.AspNetCore.NodeServices.HostingModels
+{
+    /// <summary>
+    /// Class responsible for launching a Node child process on the local machine, determining when it is ready to
+    /// accept invocations, detecting if it dies on its own, and finally terminating it on disposal.
+    ///
+    /// This abstract base class uses the input/output streams of the child process to perform a simple handshake
+    /// to determine when the child process is ready to accept invocations. This is agnostic to the mechanism that
+    /// derived classes use to actually perform the invocations (e.g., they could use HTTP-RPC, or a binary TCP
+    /// protocol, or any other RPC-type mechanism).
+    /// </summary>
+    /// <seealso cref="Microsoft.AspNetCore.NodeServices.HostingModels.INodeInstance" />
+    public abstract class OutOfProcessNodeInstance : INodeInstance
+    {
+        /// <summary>
+        /// The <see cref="ILogger"/> to which the Node.js instance's stdout/stderr is being redirected.
+        /// </summary>
+        protected readonly ILogger OutputLogger;
+
+        private const string ConnectionEstablishedMessage = "[Microsoft.AspNetCore.NodeServices:Listening]";
+        private readonly TaskCompletionSource<object> _connectionIsReadySource = new TaskCompletionSource<object>();
+        private bool _disposed;
+        private readonly StringAsTempFile _entryPointScript;
+        private FileSystemWatcher _fileSystemWatcher;
+        private int _invocationTimeoutMilliseconds;
+        private bool _launchWithDebugging;
+        private readonly Process _nodeProcess;
+        private int? _nodeDebuggingPort;
+        private bool _nodeProcessNeedsRestart;
+        private readonly string[] _watchFileExtensions;
+
+        /// <summary>
+        /// Creates a new instance of <see cref="OutOfProcessNodeInstance"/>.
+        /// </summary>
+        /// <param name="entryPointScript">The path to the entry point script that the Node instance should load and execute.</param>
+        /// <param name="projectPath">The root path of the current project. This is used when resolving Node.js module paths relative to the project root.</param>
+        /// <param name="watchFileExtensions">The filename extensions that should be watched within the project root. The Node instance will automatically shut itself down if any matching file changes.</param>
+        /// <param name="commandLineArguments">Additional command-line arguments to be passed to the Node.js instance.</param>
+        /// <param name="applicationStoppingToken">A token that indicates when the host application is stopping.</param>
+        /// <param name="nodeOutputLogger">The <see cref="ILogger"/> to which the Node.js instance's stdout/stderr (and other log information) should be written.</param>
+        /// <param name="environmentVars">Environment variables to be set on the Node.js process.</param>
+        /// <param name="invocationTimeoutMilliseconds">The maximum duration, in milliseconds, to wait for RPC calls to complete.</param>
+        /// <param name="launchWithDebugging">If true, passes a flag to the Node.js process telling it to accept V8 debugger connections.</param>
+        /// <param name="debuggingPort">If debugging is enabled, the Node.js process should listen for V8 debugger connections on this port.</param>
+        public OutOfProcessNodeInstance(
+            string entryPointScript,
+            string projectPath,
+            string[] watchFileExtensions,
+            string commandLineArguments,
+            CancellationToken applicationStoppingToken,
+            ILogger nodeOutputLogger,
+            IDictionary<string, string> environmentVars,
+            int invocationTimeoutMilliseconds,
+            bool launchWithDebugging,
+            int debuggingPort)
+        {
+            if (nodeOutputLogger == null)
+            {
+                throw new ArgumentNullException(nameof(nodeOutputLogger));
+            }
+
+            OutputLogger = nodeOutputLogger;
+            _entryPointScript = new StringAsTempFile(entryPointScript, applicationStoppingToken);
+            _invocationTimeoutMilliseconds = invocationTimeoutMilliseconds;
+            _launchWithDebugging = launchWithDebugging;
+
+            var startInfo = PrepareNodeProcessStartInfo(_entryPointScript.FileName, projectPath, commandLineArguments,
+                environmentVars, _launchWithDebugging, debuggingPort);
+            _nodeProcess = LaunchNodeProcess(startInfo);
+            _watchFileExtensions = watchFileExtensions;
+            _fileSystemWatcher = BeginFileWatcher(projectPath);
+            ConnectToInputOutputStreams();
+        }
+
+        /// <summary>
+        /// Asynchronously invokes code in the Node.js instance.
+        /// </summary>
+        /// <typeparam name="T">The JSON-serializable data type that the Node.js code will asynchronously return.</typeparam>
+        /// <param name="cancellationToken">A <see cref="CancellationToken"/> that can be used to cancel the invocation.</param>
+        /// <param name="moduleName">The path to the Node.js module (i.e., JavaScript file) relative to your project root that contains the code to be invoked.</param>
+        /// <param name="exportNameOrNull">If set, specifies the CommonJS export to be invoked. If not set, the module's default CommonJS export itself must be a function to be invoked.</param>
+        /// <param name="args">Any sequence of JSON-serializable arguments to be passed to the Node.js function.</param>
+        /// <returns>A <see cref="Task{TResult}"/> representing the completion of the RPC call.</returns>
+        public async Task<T> InvokeExportAsync<T>(
+            CancellationToken cancellationToken, string moduleName, string exportNameOrNull, params object[] args)
+        {
+            if (_nodeProcess.HasExited || _nodeProcessNeedsRestart)
+            {
+                // This special kind of exception triggers a transparent retry - NodeServicesImpl will launch
+                // a new Node instance and pass the invocation to that one instead.
+                // Note that if the Node process is listening for debugger connections, then we need it to shut
+                // down immediately and not stay open for connection draining (because if it did, the new Node
+                // instance wouldn't able to start, because the old one would still hold the debugging port).
+                var message = _nodeProcess.HasExited
+                    ? "The Node process has exited"
+                    : "The Node process needs to restart";
+                throw new NodeInvocationException(
+                    message,
+                    details: null,
+                    nodeInstanceUnavailable: true,
+                    allowConnectionDraining: !_launchWithDebugging);
+            }
+
+            // Construct a new cancellation token that combines the supplied token with the configured invocation
+            // timeout. Technically we could avoid wrapping the cancellationToken if no timeout is configured,
+            // but that's not really a major use case, since timeouts are enabled by default.
+            using (var timeoutSource = new CancellationTokenSource())
+            using (var combinedCancellationTokenSource = CancellationTokenSource.CreateLinkedTokenSource(cancellationToken, timeoutSource.Token))
+            {
+                if (_invocationTimeoutMilliseconds > 0)
+                {
+                    timeoutSource.CancelAfter(_invocationTimeoutMilliseconds);
+                }
+
+                // By overwriting the supplied cancellation token, we ensure that it isn't accidentally used
+                // below. We only want to pass through the token that respects timeouts.
+                cancellationToken = combinedCancellationTokenSource.Token;
+                var connectionDidSucceed = false;
+
+                try
+                {
+                    // Wait until the connection is established. This will throw if the connection fails to initialize,
+                    // or if cancellation is requested first. Note that we can't really cancel the "establishing connection"
+                    // task because that's shared with all callers, but we can stop waiting for it if this call is cancelled.
+                    await _connectionIsReadySource.Task.OrThrowOnCancellation(cancellationToken);
+                    connectionDidSucceed = true;
+
+                    return await InvokeExportAsync<T>(new NodeInvocationInfo
+                    {
+                        ModuleName = moduleName,
+                        ExportedFunctionName = exportNameOrNull,
+                        Args = args
+                    }, cancellationToken);
+                }
+                catch (TaskCanceledException)
+                {
+                    if (timeoutSource.IsCancellationRequested)
+                    {
+                        // It was very common for developers to report 'TaskCanceledException' when encountering almost any
+                        // trouble when using NodeServices. Now we have a default invocation timeout, and attempt to give
+                        // a more descriptive exception message if it happens.
+                        if (!connectionDidSucceed)
+                        {
+                            // This is very unlikely, but for debugging, it's still useful to differentiate it from the
+                            // case below.
+                            throw new NodeInvocationException(
+                                $"Attempt to connect to Node timed out after {_invocationTimeoutMilliseconds}ms.",
+                                string.Empty);
+                        }
+                        else
+                        {
+                            // Developers encounter this fairly often (if their Node code fails without invoking the callback,
+                            // all that the .NET side knows is that the invocation eventually times out). Previously, this surfaced
+                            // as a TaskCanceledException, but this led to a lot of issue reports. Now we throw the following
+                            // descriptive error.
+                            throw new NodeInvocationException(
+                                $"The Node invocation timed out after {_invocationTimeoutMilliseconds}ms.",
+                                $"You can change the timeout duration by setting the {NodeServicesOptions.TimeoutConfigPropertyName} "
+                                + $"property on {nameof(NodeServicesOptions)}.\n\n"
+                                + "The first debugging step is to ensure that your Node.js function always invokes the supplied "
+                                + "callback (or throws an exception synchronously), even if it encounters an error. Otherwise, "
+                                + "the .NET code has no way to know that it is finished or has failed."
+                            );
+                        }
+                    }
+                    else
+                    {
+                        throw;
+                    }
+                }
+            }
+        }
+
+        /// <summary>
+        /// Disposes this instance.
+        /// </summary>
+        public void Dispose()
+        {
+            Dispose(true);
+            GC.SuppressFinalize(this);
+        }
+
+        /// <summary>
+        /// Asynchronously invokes code in the Node.js instance.
+        /// </summary>
+        /// <typeparam name="T">The JSON-serializable data type that the Node.js code will asynchronously return.</typeparam>
+        /// <param name="invocationInfo">Specifies the Node.js function to be invoked and arguments to be passed to it.</param>
+        /// <param name="cancellationToken">A <see cref="CancellationToken"/> that can be used to cancel the invocation.</param>
+        /// <returns>A <see cref="Task{TResult}"/> representing the completion of the RPC call.</returns>
+        protected abstract Task<T> InvokeExportAsync<T>(
+            NodeInvocationInfo invocationInfo,
+            CancellationToken cancellationToken);
+
+        /// <summary>
+        /// Configures a <see cref="ProcessStartInfo"/> instance describing how to launch the Node.js process.
+        /// </summary>
+        /// <param name="entryPointFilename">The entrypoint JavaScript file that the Node.js process should execute.</param>
+        /// <param name="projectPath">The root path of the project. This is used when locating Node.js modules relative to the project root.</param>
+        /// <param name="commandLineArguments">Command-line arguments to be passed to the Node.js process.</param>
+        /// <param name="environmentVars">Environment variables to be set on the Node.js process.</param>
+        /// <param name="launchWithDebugging">If true, passes a flag to the Node.js process telling it to accept V8 Inspector connections.</param>
+        /// <param name="debuggingPort">If debugging is enabled, the Node.js process should listen for V8 Inspector connections on this port.</param>
+        /// <returns></returns>
+        protected virtual ProcessStartInfo PrepareNodeProcessStartInfo(
+            string entryPointFilename, string projectPath, string commandLineArguments,
+            IDictionary<string, string> environmentVars, bool launchWithDebugging, int debuggingPort)
+        {
+            // This method is virtual, as it provides a way to override the NODE_PATH or the path to node.exe
+            string debuggingArgs;
+            if (launchWithDebugging)
+            {
+                debuggingArgs = debuggingPort != default(int) ? $"--inspect={debuggingPort} " : "--inspect ";
+                _nodeDebuggingPort = debuggingPort;
+            }
+            else
+            {
+                debuggingArgs = string.Empty;
+            }
+
+            var thisProcessPid = Process.GetCurrentProcess().Id;
+            var startInfo = new ProcessStartInfo("node")
+            {
+                Arguments = $"{debuggingArgs}\"{entryPointFilename}\" --parentPid {thisProcessPid} {commandLineArguments ?? string.Empty}",
+                UseShellExecute = false,
+                RedirectStandardInput = true,
+                RedirectStandardOutput = true,
+                RedirectStandardError = true,
+                WorkingDirectory = projectPath
+            };
+
+            // Append environment vars
+            if (environmentVars != null)
+            {
+                foreach (var envVarKey in environmentVars.Keys)
+                {
+                    var envVarValue = environmentVars[envVarKey];
+                    if (envVarValue != null)
+                    {
+                        SetEnvironmentVariable(startInfo, envVarKey, envVarValue);
+                    }
+                }
+            }
+
+            // Append projectPath to NODE_PATH so it can locate node_modules
+            var existingNodePath = Environment.GetEnvironmentVariable("NODE_PATH") ?? string.Empty;
+            if (existingNodePath != string.Empty)
+            {
+                existingNodePath += Path.PathSeparator;
+            }
+
+            var nodePathValue = existingNodePath + Path.Combine(projectPath, "node_modules");
+            SetEnvironmentVariable(startInfo, "NODE_PATH", nodePathValue);
+
+            return startInfo;
+        }
+
+        /// <summary>
+        /// Virtual method invoked whenever the Node.js process emits a line to its stdout.
+        /// </summary>
+        /// <param name="outputData">The line emitted to the Node.js process's stdout.</param>
+        protected virtual void OnOutputDataReceived(string outputData)
+        {
+            OutputLogger.LogInformation(outputData);
+        }
+
+        /// <summary>
+        /// Virtual method invoked whenever the Node.js process emits a line to its stderr.
+        /// </summary>
+        /// <param name="errorData">The line emitted to the Node.js process's stderr.</param>
+        protected virtual void OnErrorDataReceived(string errorData)
+        {
+            OutputLogger.LogError(errorData);
+        }
+
+        /// <summary>
+        /// Disposes the instance.
+        /// </summary>
+        /// <param name="disposing">True if the object is disposing or false if it is finalizing.</param>
+        protected virtual void Dispose(bool disposing)
+        {
+            if (!_disposed)
+            {
+                if (disposing)
+                {
+                    _entryPointScript.Dispose();
+                    EnsureFileSystemWatcherIsDisposed();
+                }
+
+                // Make sure the Node process is finished
+                // TODO: Is there a more graceful way to end it? Or does this still let it perform any cleanup?
+                if (_nodeProcess != null && !_nodeProcess.HasExited)
+                {
+                    _nodeProcess.Kill();
+                }
+
+                _disposed = true;
+            }
+        }
+
+        private void EnsureFileSystemWatcherIsDisposed()
+        {
+            if (_fileSystemWatcher != null)
+            {
+                _fileSystemWatcher.Dispose();
+                _fileSystemWatcher = null;
+            }
+        }
+
+        private static void SetEnvironmentVariable(ProcessStartInfo startInfo, string name, string value)
+        {
+            startInfo.Environment[name] = value;
+        }
+
+        private static Process LaunchNodeProcess(ProcessStartInfo startInfo)
+        {
+            try {
+                var process = Process.Start(startInfo);
+
+                // On Mac at least, a killed child process is left open as a zombie until the parent
+                // captures its exit code. We don't need the exit code for this process, and don't want
+                // to use process.WaitForExit() explicitly (we'd have to block the thread until it really
+                // has exited), but we don't want to leave zombies lying around either. It's sufficient
+                // to use process.EnableRaisingEvents so that .NET will grab the exit code and let the
+                // zombie be cleaned away without having to block our thread.
+                process.EnableRaisingEvents = true;
+
+                return process;
+            } catch (Exception ex) {
+                var message = "Failed to start Node process. To resolve this:.\n\n"
+                            + "[1] Ensure that Node.js is installed and can be found in one of the PATH directories.\n"
+                            + $"    Current PATH enviroment variable is: { Environment.GetEnvironmentVariable("PATH") }\n"
+                            + "    Make sure the Node executable is in one of those directories, or update your PATH.\n\n"
+                            + "[2] See the InnerException for further details of the cause.";
+                throw new InvalidOperationException(message, ex);
+            }
+        }
+
+        private static string UnencodeNewlines(string str)
+        {
+            if (str != null)
+            {
+                // The token here needs to match the const in OverrideStdOutputs.ts.
+                // See the comment there for why we're doing this.
+                str = str.Replace("__ns_newline__", Environment.NewLine);
+            }
+
+            return str;
+        }
+
+        private void ConnectToInputOutputStreams()
+        {
+            var initializationIsCompleted = false;
+
+            _nodeProcess.OutputDataReceived += (sender, evt) =>
+            {
+                if (evt.Data == ConnectionEstablishedMessage && !initializationIsCompleted)
+                {
+                    _connectionIsReadySource.SetResult(null);
+                    initializationIsCompleted = true;
+                }
+                else if (evt.Data != null)
+                {
+                    OnOutputDataReceived(UnencodeNewlines(evt.Data));
+                }
+            };
+
+            _nodeProcess.ErrorDataReceived += (sender, evt) =>
+            {
+                if (evt.Data != null)
+                {
+                    if (_launchWithDebugging && IsDebuggerMessage(evt.Data))
+                    {
+                        OutputLogger.LogWarning(evt.Data);
+                    }
+                    else
+                    {
+                        OnErrorDataReceived(UnencodeNewlines(evt.Data));
+                    }
+                }
+            };
+
+            _nodeProcess.BeginOutputReadLine();
+            _nodeProcess.BeginErrorReadLine();
+        }
+
+        private static bool IsDebuggerMessage(string message)
+        {
+            return message.StartsWith("Debugger attached", StringComparison.Ordinal) ||
+                message.StartsWith("Debugger listening ", StringComparison.Ordinal) ||
+                message.StartsWith("To start debugging", StringComparison.Ordinal) ||
+                message.Equals("Warning: This is an experimental feature and could change at any time.", StringComparison.Ordinal) ||
+                message.Equals("For help see https://nodejs.org/en/docs/inspector", StringComparison.Ordinal) ||
+                message.Contains("chrome-devtools:");
+        }
+
+        private FileSystemWatcher BeginFileWatcher(string rootDir)
+        {
+            if (_watchFileExtensions == null || _watchFileExtensions.Length == 0)
+            {
+                // Nothing to watch
+                return null;
+            }
+
+            var watcher = new FileSystemWatcher(rootDir)
+            {
+                IncludeSubdirectories = true,
+                NotifyFilter = NotifyFilters.LastWrite | NotifyFilters.FileName | NotifyFilters.DirectoryName
+            };
+            watcher.Changed += OnFileChanged;
+            watcher.Created += OnFileChanged;
+            watcher.Deleted += OnFileChanged;
+            watcher.Renamed += OnFileRenamed;
+            watcher.EnableRaisingEvents = true;
+            return watcher;
+        }
+
+        private void OnFileChanged(object source, FileSystemEventArgs e)
+        {
+            if (IsFilenameBeingWatched(e.FullPath))
+            {
+                RestartDueToFileChange(e.FullPath);
+            }
+        }
+
+        private void OnFileRenamed(object source, RenamedEventArgs e)
+        {
+            if (IsFilenameBeingWatched(e.OldFullPath) || IsFilenameBeingWatched(e.FullPath))
+            {
+                RestartDueToFileChange(e.OldFullPath);
+            }
+        }
+
+        private bool IsFilenameBeingWatched(string fullPath)
+        {
+            if (string.IsNullOrEmpty(fullPath))
+            {
+                return false;
+            }
+            else
+            {
+                var actualExtension = Path.GetExtension(fullPath) ?? string.Empty;
+                return _watchFileExtensions.Any(actualExtension.Equals);
+            }
+        }
+
+        private void RestartDueToFileChange(string fullPath)
+        {
+            OutputLogger.LogInformation($"Node will restart because file changed: {fullPath}");
+
+            _nodeProcessNeedsRestart = true;
+
+            // There's no need to watch for any more changes, since we're already restarting, and if the
+            // restart takes some time (e.g., due to connection draining), we could end up getting duplicate
+            // notifications.
+            EnsureFileSystemWatcherIsDisposed();
+        }
+
+        /// <summary>
+        /// Implements the finalization part of the IDisposable pattern by calling Dispose(false).
+        /// </summary>
+        ~OutOfProcessNodeInstance()
+        {
+            Dispose(false);
+        }
+    }
+}