start

.gitignore

@@ -0,0 +1,6 @@
+# runtime dependencies are checked in
+# dev dependencies are *not* checked in
+node_modules/.bin
+node_modules/typescript
+node_modules/@types
+node_modules/prettier

.prettierrc.json

@@ -0,0 +1,11 @@
+{
+    "printWidth": 80,
+    "tabWidth": 2,
+    "useTabs": false,
+    "semi": true,
+    "singleQuote": true,
+    "trailingComma": "none",
+    "bracketSpacing": false,
+    "arrowParens": "avoid",
+    "parser": "typescript"
+  }

README.md

@@ -3,9 +3,9 @@
 This action sets by node environment for use in actions by:
 
 - optionally downloading and caching a version of node - npm by version spec and add to PATH
-- registering problem matchers for error output 
-- configuring authentication for npm packages 
-- configuring proxy if the runner is configured to use a proxy (coming with private runners)
+- TODO: registering problem matchers for error output 
+- TODO: configuring authentication for npm packages 
+- TODO: configuring proxy if the runner is configured to use a proxy (coming with private runners)
 
 # Usage
 
@@ -40,4 +40,8 @@ workflow:
 
 # License
 
-The scripts and documentation in this project are released under the [MIT License](LICENSE)
+The scripts and documentation in this project are released under the [MIT License](LICENSE)
+
+# Contributions
+
+Contributions are welcome!  See [Contributor's Guide](docs/contributors.md)

action.yml

@@ -5,9 +5,6 @@ inputs:
   version:
     description: 'Version Spec of the version to use.  Examples: 10.x, 10.15.1, >=10.15.0'
     default: '10.x'
-  checkLatest:
-    description: 'Always checks online for the latest available version that satisfies the version spec. This is typically false unless you have a specific scenario to always get latest. This will cause it to incur download costs when potentially not necessary, especially with the hosted build pool.'
-    default: 'false'
 runs:
   using: 'node'
-  main: 'usenode.js'
+  main: 'lib/setup-node.js'

docs/contributors.md

@@ -0,0 +1,17 @@
+# Contributors
+
+
+# Checkin
+
+- Do checkin source (src)
+- Do checkin build output (lib)
+- Do checkin runtime node_modules
+- Do not checkin 
+
+# Adding a dev dependency
+
+Remember to update .gitignore.  
+
+# Updating toolkit dependency
+
+Until released publically, update tgz packages in toolkit

lib/installer.js

@@ -0,0 +1,223 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core = __importStar(require("@actions/core"));
+const io = __importStar(require("@actions/io"));
+const tc = __importStar(require("@actions/tool-cache"));
+const restm = __importStar(require("typed-rest-client/RestClient"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const semver = __importStar(require("semver"));
+let osPlat = os.platform();
+let osArch = os.arch();
+function getNode(versionSpec) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // check cache
+        let toolPath;
+        toolPath = tc.find('node', versionSpec);
+        // If not found in cache, download
+        if (!toolPath) {
+            let version;
+            const c = semver.clean(versionSpec) || '';
+            // If explicit version
+            if (semver.valid(c) != null) {
+                // version to download
+                version = versionSpec;
+            }
+            else {
+                // query nodejs.org for a matching version
+                version = yield queryLatestMatch(versionSpec);
+                if (!version) {
+                    throw new Error(`Unable to find Node version '${versionSpec}' for platform ${osPlat} and architecture ${osArch}.`);
+                }
+                // check cache
+                toolPath = tc.find('node', version);
+            }
+            if (!toolPath) {
+                // download, extract, cache
+                toolPath = yield acquireNode(version);
+            }
+        }
+        //
+        // a tool installer initimately knows details about the layout of that tool
+        // for example, node binary is in the bin folder after the extract on Mac/Linux.
+        // layouts could change by version, by platform etc... but that's the tool installers job
+        //
+        if (osPlat != 'win32') {
+            toolPath = path.join(toolPath, 'bin');
+        }
+        //
+        // prepend the tools path. instructs the agent to prepend for future tasks
+        //
+        // TODO - addPath not implemented yet (this should probably actually be in core)
+        // tc.addPath(toolPath);
+    });
+}
+exports.getNode = getNode;
+function queryLatestMatch(versionSpec) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // node offers a json list of versions
+        let dataFileName;
+        switch (osPlat) {
+            case 'linux':
+                dataFileName = 'linux-' + osArch;
+                break;
+            case 'darwin':
+                dataFileName = 'osx-' + osArch + '-tar';
+                break;
+            case 'win32':
+                dataFileName = 'win-' + osArch + '-exe';
+                break;
+            default:
+                throw new Error(`Unexpected OS '${osPlat}'`);
+        }
+        let versions = [];
+        let dataUrl = 'https://nodejs.org/dist/index.json';
+        let rest = new restm.RestClient('vsts-node-tool');
+        let nodeVersions = (yield rest.get(dataUrl)).result || [];
+        nodeVersions.forEach((nodeVersion) => {
+            // ensure this version supports your os and platform
+            if (nodeVersion.files.indexOf(dataFileName) >= 0) {
+                versions.push(nodeVersion.version);
+            }
+        });
+        // get the latest version that matches the version spec
+        let version = evaluateVersions(versions, versionSpec);
+        return version;
+    });
+}
+// TODO - should we just export this from @actions/tool-cache? Lifted directly from there
+function evaluateVersions(versions, versionSpec) {
+    let version = '';
+    core.debug(`evaluating ${versions.length} versions`);
+    versions = versions.sort((a, b) => {
+        if (semver.gt(a, b)) {
+            return 1;
+        }
+        return -1;
+    });
+    for (let i = versions.length - 1; i >= 0; i--) {
+        const potential = versions[i];
+        const satisfied = semver.satisfies(potential, versionSpec);
+        if (satisfied) {
+            version = potential;
+            break;
+        }
+    }
+    if (version) {
+        core.debug(`matched: ${version}`);
+    }
+    else {
+        core.debug('match not found');
+    }
+    return version;
+}
+function acquireNode(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        //
+        // Download - a tool installer intimately knows how to get the tool (and construct urls)
+        //
+        version = semver.clean(version) || '';
+        let fileName = osPlat == 'win32'
+            ? 'node-v' + version + '-win-' + os.arch()
+            : 'node-v' + version + '-' + osPlat + '-' + os.arch();
+        let urlFileName = osPlat == 'win32' ? fileName + '.7z' : fileName + '.tar.gz';
+        let downloadUrl = 'https://nodejs.org/dist/v' + version + '/' + urlFileName;
+        let downloadPath;
+        try {
+            downloadPath = yield tc.downloadTool(downloadUrl);
+        }
+        catch (err) {
+            if (err['httpStatusCode'] && err['httpStatusCode'] === '404') {
+                return yield acquireNodeFromFallbackLocation(version);
+            }
+            throw err;
+        }
+        //
+        // Extract
+        //
+        let extPath;
+        if (osPlat == 'win32') {
+            extPath = getAgentTemp();
+            if (!extPath) {
+                throw new Error('Expected Agent.TempDirectory to be set');
+            }
+            let _7zPath = path.join(__dirname, '7zr.exe');
+            extPath = yield tc.extract7z(downloadPath, extPath);
+        }
+        else {
+            extPath = yield tc.extractTar(downloadPath);
+        }
+        //
+        // Install into the local tool cache - node extracts with a root folder that matches the fileName downloaded
+        //
+        let toolRoot = path.join(extPath, fileName);
+        return yield tc.cacheDir(toolRoot, 'node', version);
+    });
+}
+// For non LTS versions of Node, the files we need (for Windows) are sometimes located
+// in a different folder than they normally are for other versions.
+// Normally the format is similar to: https://nodejs.org/dist/v5.10.1/node-v5.10.1-win-x64.7z
+// In this case, there will be two files located at:
+//      /dist/v5.10.1/win-x64/node.exe
+//      /dist/v5.10.1/win-x64/node.lib
+// If this is not the structure, there may also be two files located at:
+//      /dist/v0.12.18/node.exe
+//      /dist/v0.12.18/node.lib
+// This method attempts to download and cache the resources from these alternative locations.
+// Note also that the files are normally zipped but in this case they are just an exe
+// and lib file in a folder, not zipped.
+function acquireNodeFromFallbackLocation(version) {
+    return __awaiter(this, void 0, void 0, function* () {
+        // Create temporary folder to download in to
+        let tempDownloadFolder = 'temp_' + Math.floor(Math.random() * 2000000000);
+        let tempDir = path.join(getAgentTemp(), tempDownloadFolder);
+        yield io.mkdirP(tempDir);
+        let exeUrl;
+        let libUrl;
+        try {
+            exeUrl = `https://nodejs.org/dist/v${version}/win-${os.arch()}/node.exe`;
+            libUrl = `https://nodejs.org/dist/v${version}/win-${os.arch()}/node.lib`;
+            const exePath = yield tc.downloadTool(exeUrl);
+            yield io.mv(exePath, path.join(tempDir, 'node.exe'));
+            const libPath = yield tc.downloadTool(libUrl);
+            yield io.mv(libPath, path.join(tempDir, 'node.lib'));
+        }
+        catch (err) {
+            if (err['httpStatusCode'] && err['httpStatusCode'] === '404') {
+                exeUrl = `https://nodejs.org/dist/v${version}/node.exe`;
+                libUrl = `https://nodejs.org/dist/v${version}/node.lib`;
+                const exePath = yield tc.downloadTool(exeUrl);
+                yield io.mv(exePath, path.join(tempDir, 'node.exe'));
+                const libPath = yield tc.downloadTool(libUrl);
+                yield io.mv(libPath, path.join(tempDir, 'node.lib'));
+            }
+            else {
+                throw err;
+            }
+        }
+        return yield tc.cacheDir(tempDir, 'node', version);
+    });
+}
+function getAgentTemp() {
+    // TODO - we need an actual protocol for this (this is just a placeholder)
+    const tempDirectory = process.env['Runner.TempDirectory'];
+    if (!tempDirectory) {
+        throw new Error('Runner.TempDirectory is not set');
+    }
+    return tempDirectory;
+}

lib/setup-node.js

@@ -0,0 +1,40 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (Object.hasOwnProperty.call(mod, k)) result[k] = mod[k];
+    result["default"] = mod;
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const core = __importStar(require("@actions/core"));
+const installer = __importStar(require("./installer"));
+function run() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            //
+            // Version is optional.  If supplied, install / use from the tool cache
+            // If not supplied then task is still used to setup proxy, auth, etc...
+            //
+            const version = core.getInput('version');
+            if (version) {
+                // TODO: installer doesn't support proxy
+                yield installer.getNode(version);
+            }
+            // TODO: setup proxy from runner proxy config
+            // TODO: problem matchers registered
+        }
+        catch (error) {
+            core.setFailed(error.message);
+        }
+    });
+}
+run();