@highstate/designer 0.3.2 → 0.3.3

package/.output/server/node_modules/@pulumi/pulumi/automation/localWorkspace.js

@@ -0,0 +1,1049 @@
+"use strict";
+// Copyright 2016-2023, Pulumi Corporation.
+//
+// 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.
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    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) : adopt(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 fs = __importStar(require("fs"));
+const yaml = __importStar(require("js-yaml"));
+const os = __importStar(require("os"));
+const semver = __importStar(require("semver"));
+const upath = __importStar(require("upath"));
+const cmd_1 = require("./cmd");
+const stack_1 = require("./stack");
+const stackSettings_1 = require("./stackSettings");
+const SKIP_VERSION_CHECK_VAR = "PULUMI_AUTOMATION_API_SKIP_VERSION_CHECK";
+/**
+ * {@link LocalWorkspace} is a default implementation of the {@link Workspace} interface.
+ *
+ * A {@link Workspace} is the execution context containing a single Pulumi
+ * project, a program, and multiple stacks. Workspaces are used to manage the
+ * execution environment, providing various utilities such as plugin
+ * installation, environment configuration (`$PULUMI_HOME`), and creation,
+ * deletion, and listing of Stacks.
+ *
+ * {@link LocalWorkspace} relies on `Pulumi.yaml` and `Pulumi.<stack>.yaml` as
+ * the intermediate format for Project and Stack settings. Modifying the
+ * workspace's {@link ProjectSettings} will alter the workspace's `Pulumi.yaml`
+ * file, and setting config on a Stack will modify the relevant
+ * `Pulumi.<stack>.yaml` file. This is identical to the behavior of Pulumi CLI
+ * driven workspaces.
+ *
+ * @alpha
+ */
+class LocalWorkspace {
+    /**
+     * Constructs a new {@link LocalWorkspace}.
+     */
+    constructor(opts) {
+        let dir = "";
+        let envs = {};
+        if (opts) {
+            const { workDir, pulumiHome, program, envVars, secretsProvider, remote, remoteGitProgramArgs, remotePreRunCommands, remoteEnvVars, remoteSkipInstallDependencies, remoteInheritSettings, } = opts;
+            if (workDir) {
+                // Verify that the workdir exists.
+                if (!fs.existsSync(workDir)) {
+                    throw new Error(`Invalid workDir passed to local workspace: '${workDir}' does not exist`);
+                }
+                dir = workDir;
+            }
+            this.pulumiHome = pulumiHome;
+            this.program = program;
+            this.secretsProvider = secretsProvider;
+            this.remote = remote;
+            this.remoteGitProgramArgs = remoteGitProgramArgs;
+            this.remotePreRunCommands = remotePreRunCommands;
+            this.remoteEnvVars = Object.assign({}, remoteEnvVars);
+            this.remoteSkipInstallDependencies = remoteSkipInstallDependencies;
+            this.remoteInheritSettings = remoteInheritSettings;
+            envs = Object.assign({}, envVars);
+        }
+        if (!dir) {
+            dir = fs.mkdtempSync(upath.joinSafe(os.tmpdir(), "automation-"));
+        }
+        this.workDir = dir;
+        this.envVars = envs;
+        const skipVersionCheck = !!this.envVars[SKIP_VERSION_CHECK_VAR] || !!process.env[SKIP_VERSION_CHECK_VAR];
+        const pulumiCommand = (opts === null || opts === void 0 ? void 0 : opts.pulumiCommand) ? Promise.resolve(opts.pulumiCommand)
+            : cmd_1.PulumiCommand.get({ skipVersionCheck });
+        const readinessPromises = [
+            pulumiCommand.then((p) => {
+                this._pulumiCommand = p;
+                if (p.version) {
+                    this._pulumiVersion = p.version;
+                }
+                return this.checkRemoteSupport();
+            }),
+        ];
+        if (opts === null || opts === void 0 ? void 0 : opts.projectSettings) {
+            readinessPromises.push(this.saveProjectSettings(opts.projectSettings));
+        }
+        if (opts === null || opts === void 0 ? void 0 : opts.stackSettings) {
+            for (const [name, value] of Object.entries(opts.stackSettings)) {
+                readinessPromises.push(this.saveStackSettings(name, value));
+            }
+        }
+        this.ready = Promise.all(readinessPromises);
+    }
+    /**
+     * The underlying Pulumi CLI.
+     */
+    get pulumiCommand() {
+        if (this._pulumiCommand === undefined) {
+            throw new Error("Failed to get Pulumi CLI");
+        }
+        return this._pulumiCommand;
+    }
+    /**
+     * The version of the underlying Pulumi CLI/engine.
+     *
+     * @returns A string representation of the version, if available. `null` otherwise.
+     */
+    get pulumiVersion() {
+        if (this._pulumiVersion === undefined) {
+            throw new Error(`Failed to get Pulumi version`);
+        }
+        return this._pulumiVersion.toString();
+    }
+    /**
+     * Creates a workspace using the specified options. Used for maximal control and customization
+     * of the underlying environment before any stacks are created or selected.
+     *
+     * @param opts Options used to configure the Workspace
+     */
+    static create(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const ws = new LocalWorkspace(opts);
+            yield ws.ready;
+            return ws;
+        });
+    }
+    static createStack(args, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isInlineProgramArgs(args)) {
+                return yield this.inlineSourceStackHelper(args, stack_1.Stack.create, opts);
+            }
+            else if (isLocalProgramArgs(args)) {
+                return yield this.localSourceStackHelper(args, stack_1.Stack.create, opts);
+            }
+            throw new Error(`unexpected args: ${args}`);
+        });
+    }
+    static selectStack(args, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isInlineProgramArgs(args)) {
+                return yield this.inlineSourceStackHelper(args, stack_1.Stack.select, opts);
+            }
+            else if (isLocalProgramArgs(args)) {
+                return yield this.localSourceStackHelper(args, stack_1.Stack.select, opts);
+            }
+            throw new Error(`unexpected args: ${args}`);
+        });
+    }
+    static createOrSelectStack(args, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (isInlineProgramArgs(args)) {
+                return yield this.inlineSourceStackHelper(args, stack_1.Stack.createOrSelect, opts);
+            }
+            else if (isLocalProgramArgs(args)) {
+                return yield this.localSourceStackHelper(args, stack_1.Stack.createOrSelect, opts);
+            }
+            throw new Error(`unexpected args: ${args}`);
+        });
+    }
+    static localSourceStackHelper(args, initFn, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let wsOpts = { workDir: args.workDir };
+            if (opts) {
+                wsOpts = Object.assign(Object.assign({}, opts), { workDir: args.workDir });
+            }
+            const ws = new LocalWorkspace(wsOpts);
+            yield ws.ready;
+            return yield initFn(args.stackName, ws);
+        });
+    }
+    static inlineSourceStackHelper(args, initFn, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let wsOpts = { program: args.program };
+            if (opts) {
+                wsOpts = Object.assign(Object.assign({}, opts), { program: args.program });
+            }
+            if (!wsOpts.projectSettings) {
+                if (wsOpts.workDir) {
+                    try {
+                        // Try to load the project settings.
+                        loadProjectSettings(wsOpts.workDir);
+                    }
+                    catch (e) {
+                        // If it failed to find the project settings file, set a default project.
+                        if (e.toString().includes("failed to find project settings")) {
+                            wsOpts.projectSettings = defaultProject(args.projectName);
+                        }
+                        else {
+                            throw e;
+                        }
+                    }
+                }
+                else {
+                    wsOpts.projectSettings = defaultProject(args.projectName);
+                }
+            }
+            const ws = new LocalWorkspace(wsOpts);
+            yield ws.ready;
+            return yield initFn(args.stackName, ws);
+        });
+    }
+    /**
+     * Returns the settings object for the current project if any
+     * {@link LocalWorkspace} reads settings from the `Pulumi.yaml`
+     * in the workspace. A workspace can contain only a single project at a
+     * time.
+     */
+    projectSettings() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return loadProjectSettings(this.workDir);
+        });
+    }
+    /**
+     * Overwrites the settings object in the current project. There can only be
+     * a single project per workspace. Fails if new project name does not match
+     * old. {@link LocalWorkspace} writes this value to a `Pulumi.yaml` file in
+     * `Workspace.WorkDir()`.
+     *
+     * @param settings
+     *  The settings object to save to the Workspace.
+     */
+    saveProjectSettings(settings) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let foundExt = ".yaml";
+            for (const ext of settingsExtensions) {
+                const testPath = upath.joinSafe(this.workDir, `Pulumi${ext}`);
+                if (fs.existsSync(testPath)) {
+                    foundExt = ext;
+                    break;
+                }
+            }
+            const path = upath.joinSafe(this.workDir, `Pulumi${foundExt}`);
+            let contents;
+            if (foundExt === ".json") {
+                contents = JSON.stringify(settings, null, 4);
+            }
+            else {
+                contents = yaml.safeDump(settings, { skipInvalid: true });
+            }
+            return fs.writeFileSync(path, contents);
+        });
+    }
+    /**
+     * Returns the settings object for the stack matching the specified stack
+     * name if any. {@link LocalWorkspace} reads this from a
+     * `Pulumi.<stack>.yaml` file in `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to retrieve settings from.
+     */
+    stackSettings(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stackSettingsName = getStackSettingsName(stackName);
+            for (const ext of settingsExtensions) {
+                const isJSON = ext === ".json";
+                const path = upath.joinSafe(this.workDir, `Pulumi.${stackSettingsName}${ext}`);
+                if (!fs.existsSync(path)) {
+                    continue;
+                }
+                const contents = fs.readFileSync(path).toString();
+                let stackSettings;
+                if (isJSON) {
+                    stackSettings = JSON.parse(contents);
+                }
+                stackSettings = yaml.safeLoad(contents);
+                // Transform the serialized representation back to what we expect.
+                for (const key of stackSettings_1.stackSettingsSerDeKeys) {
+                    if (stackSettings.hasOwnProperty(key[0])) {
+                        stackSettings[key[1]] = stackSettings[key[0]];
+                        delete stackSettings[key[0]];
+                    }
+                }
+                return stackSettings;
+            }
+            throw new Error(`failed to find stack settings file in workdir: ${this.workDir}`);
+        });
+    }
+    /**
+     * Overwrites the settings object for the stack matching the specified stack
+     * name. {@link LocalWorkspace} writes this value to a `Pulumi.<stack>.yaml`
+     * file in `Workspace.WorkDir()`
+     *
+     * @param stackName
+     *  The stack to operate on.
+     * @param settings
+     *  The settings object to save.
+     */
+    saveStackSettings(stackName, settings) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stackSettingsName = getStackSettingsName(stackName);
+            let foundExt = ".yaml";
+            for (const ext of settingsExtensions) {
+                const testPath = upath.joinSafe(this.workDir, `Pulumi.${stackSettingsName}${ext}`);
+                if (fs.existsSync(testPath)) {
+                    foundExt = ext;
+                    break;
+                }
+            }
+            const path = upath.joinSafe(this.workDir, `Pulumi.${stackSettingsName}${foundExt}`);
+            const serializeSettings = Object.assign({}, settings);
+            let contents;
+            // Transform the keys to the serialized representation that we expect.
+            for (const key of stackSettings_1.stackSettingsSerDeKeys) {
+                if (serializeSettings.hasOwnProperty(key[1])) {
+                    serializeSettings[key[0]] = serializeSettings[key[1]];
+                    delete serializeSettings[key[1]];
+                }
+            }
+            if (foundExt === ".json") {
+                contents = JSON.stringify(serializeSettings, null, 4);
+            }
+            else {
+                contents = yaml.safeDump(serializeSettings, { skipInvalid: true });
+            }
+            return fs.writeFileSync(path, contents);
+        });
+    }
+    /**
+     * Creates and sets a new stack with the stack name, failing if one already
+     * exists.
+     *
+     * @param stackName The stack to create.
+     */
+    createStack(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["stack", "init", stackName];
+            if (this.secretsProvider) {
+                args.push("--secrets-provider", this.secretsProvider);
+            }
+            if (this.isRemote) {
+                args.push("--no-select");
+            }
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Selects and sets an existing stack matching the stack name, failing if
+     * none exists.
+     *
+     * @param stackName The stack to select.
+     */
+    selectStack(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // If this is a remote workspace, we don't want to actually select the stack (which would modify global state);
+            // but we will ensure the stack exists by calling `pulumi stack`.
+            const args = ["stack"];
+            if (!this.isRemote) {
+                args.push("select");
+            }
+            args.push("--stack", stackName);
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Deletes the stack and all associated configuration and history.
+     *
+     * @param stackName The stack to remove
+     */
+    removeStack(stackName, opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["stack", "rm", "--yes"];
+            if (opts === null || opts === void 0 ? void 0 : opts.force) {
+                args.push("--force");
+            }
+            if (opts === null || opts === void 0 ? void 0 : opts.preserveConfig) {
+                args.push("--preserve-config");
+            }
+            args.push(stackName);
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Adds environments to the end of a stack's import list. Imported
+     * environments are merged in order per the ESC merge rules. The list of
+     * environments behaves as if it were the import list in an anonymous
+     * environment.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param environments
+     *  The names of the environments to add to the stack's configuration
+     */
+    addEnvironments(stackName, ...environments) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let ver = this._pulumiVersion;
+            if (ver === undefined) {
+                // Assume an old version. Doesn't really matter what this is as long as it's pre-3.95.
+                ver = semver.parse("3.0.0");
+            }
+            // 3.95 added this command (https://github.com/pulumi/pulumi/releases/tag/v3.95.0)
+            if (ver.compare("3.95.0") < 0) {
+                throw new Error(`addEnvironments requires Pulumi version >= 3.95.0`);
+            }
+            yield this.runPulumiCmd(["config", "env", "add", ...environments, "--stack", stackName, "--yes"]);
+        });
+    }
+    /**
+     * Returns the list of environments associated with the specified stack name.
+     *
+     * @param stackName The stack to operate on
+     */
+    listEnvironments(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let ver = this._pulumiVersion;
+            if (ver === undefined) {
+                // Assume an old version. Doesn't really matter what this is as long as it's pre-3.99.
+                ver = semver.parse("3.0.0");
+            }
+            // 3.99 added this command (https://github.com/pulumi/pulumi/releases/tag/v3.99.0)
+            if (ver.compare("3.99.0") < 0) {
+                throw new Error(`listEnvironments requires Pulumi version >= 3.99.0`);
+            }
+            const result = yield this.runPulumiCmd(["config", "env", "ls", "--stack", stackName, "--json"]);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Removes an environment from a stack's import list.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param environment
+     *  The name of the environment to remove from the stack's configuration
+     */
+    removeEnvironment(stackName, environment) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let ver = this._pulumiVersion;
+            if (ver === undefined) {
+                // Assume an old version. Doesn't really matter what this is as long as it's pre-3.95.
+                ver = semver.parse("3.0.0");
+            }
+            // 3.95 added this command (https://github.com/pulumi/pulumi/releases/tag/v3.95.0)
+            if (ver.compare("3.95.0") < 0) {
+                throw new Error(`removeEnvironments requires Pulumi version >= 3.95.0`);
+            }
+            yield this.runPulumiCmd(["config", "env", "rm", environment, "--stack", stackName, "--yes"]);
+        });
+    }
+    /**
+     * Returns the value associated with the specified stack name and key,
+     * scoped to the current workspace. {@link LocalWorkspace} reads this config
+     * from the matching `Pulumi.stack.yaml` file.
+     *
+     * @param stackName
+     *  The stack to read config from
+     * @param key
+     *  The key to use for the config lookup
+     * @param path
+     *  The key contains a path to a property in a map or list to get
+     */
+    getConfig(stackName, key, path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["config", "get"];
+            if (path) {
+                args.push("--path");
+            }
+            args.push(key, "--json", "--stack", stackName);
+            const result = yield this.runPulumiCmd(args);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Returns the config map for the specified stack name, scoped to the
+     * current workspace. {@link LocalWorkspace} reads this config from the
+     * matching `Pulumi.stack.yaml` file.
+     *
+     * @param stackName
+     *  The stack to read config from
+     */
+    getAllConfig(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.runPulumiCmd(["config", "--show-secrets", "--json", "--stack", stackName]);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Sets the specified key-value pair on the provided stack name. {@link
+     * LocalWorkspace} writes this value to the matching `Pulumi.<stack>.yaml`
+     * file in `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param key
+     *  The config key to set
+     * @param value
+     *  The value to set
+     * @param path
+     *  The key contains a path to a property in a map or list to set
+     */
+    setConfig(stackName, key, value, path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["config", "set"];
+            if (path) {
+                args.push("--path");
+            }
+            const secretArg = value.secret ? "--secret" : "--plaintext";
+            args.push(key, "--stack", stackName, secretArg, "--non-interactive", "--", value.value);
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Sets all values in the provided config map for the specified stack name.
+     * {@link LocalWorkspace} writes the config to the matching
+     * `Pulumi.<stack>.yaml` file in `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param config
+     *  The {@link ConfigMap} to upsert against the existing config
+     * @param path
+     *  The keys contain a path to a property in a map or list to set
+     */
+    setAllConfig(stackName, config, path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["config", "set-all", "--stack", stackName];
+            if (path) {
+                args.push("--path");
+            }
+            for (const [key, value] of Object.entries(config)) {
+                const secretArg = value.secret ? "--secret" : "--plaintext";
+                args.push(secretArg, `${key}=${value.value}`);
+            }
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Removes the specified key-value pair on the provided stack name. Will
+     * remove any matching values in the `Pulumi.<stack>.yaml` file in
+     * `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param key
+     *  The config key to remove
+     * @param path
+     *  The key contains a path to a property in a map or list to remove
+     */
+    removeConfig(stackName, key, path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["config", "rm", key, "--stack", stackName];
+            if (path) {
+                args.push("--path");
+            }
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Removes all values in the provided key list for the specified stack name
+     * Will remove any matching values in the `Pulumi.<stack>.yaml` file in
+     * `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to operate on
+     * @param keys
+     *  The list of keys to remove from the underlying config
+     * @param path
+     *  The keys contain a path to a property in a map or list to remove
+     */
+    removeAllConfig(stackName, keys, path) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["config", "rm-all", "--stack", stackName];
+            if (path) {
+                args.push("--path");
+            }
+            args.push(...keys);
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Gets and sets the config map used with the last update for the stack
+     * matching the given name. This will overwrite all configuration in the
+     * `Pulumi.<stack>.yaml` file in `Workspace.WorkDir()`.
+     *
+     * @param stackName
+     *  The stack to refresh
+     */
+    refreshConfig(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.runPulumiCmd(["config", "refresh", "--force", "--stack", stackName]);
+            return this.getAllConfig(stackName);
+        });
+    }
+    /**
+     * Returns the value associated with the specified stack name and key,
+     * scoped to the {@link LocalWorkspace.}
+     *
+     * @param stackName
+     *  The stack to read tag metadata from.
+     * @param key
+     *  The key to use for the tag lookup.
+     */
+    getTag(stackName, key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.runPulumiCmd(["stack", "tag", "get", key, "--stack", stackName]);
+            return result.stdout.trim();
+        });
+    }
+    /**
+     * Sets the specified key-value pair on the stack with the given name.
+     *
+     * @param stackName
+     *  The stack to operate on.
+     * @param key
+     *  The tag key to set.
+     * @param value
+     *  The tag value to set.
+     */
+    setTag(stackName, key, value) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.runPulumiCmd(["stack", "tag", "set", key, value, "--stack", stackName]);
+        });
+    }
+    /**
+     * Removes the specified key-value pair on the stack with the given name.
+     *
+     * @param stackName
+     *  The stack to operate on.
+     * @param key
+     *  The tag key to remove.
+     */
+    removeTag(stackName, key) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.runPulumiCmd(["stack", "tag", "rm", key, "--stack", stackName]);
+        });
+    }
+    /**
+     * Returns the tag map for the specified stack, scoped to the current
+     * {@link LocalWorkspace.}
+     *
+     * @param stackName
+     *  The stack to read tag metadata from.
+     */
+    listTags(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.runPulumiCmd(["stack", "tag", "ls", "--json", "--stack", stackName]);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Returns information about the currently authenticated user.
+     */
+    whoAmI() {
+        return __awaiter(this, void 0, void 0, function* () {
+            let ver = this._pulumiVersion;
+            if (ver === undefined) {
+                // Assume an old version. Doesn't really matter what this is as long as it's pre-3.58.
+                ver = semver.parse("3.0.0");
+            }
+            // 3.58 added the --json flag (https://github.com/pulumi/pulumi/releases/tag/v3.58.0)
+            if (ver.compare("3.58.0") >= 0) {
+                const result = yield this.runPulumiCmd(["whoami", "--json"]);
+                return JSON.parse(result.stdout);
+            }
+            else {
+                const result = yield this.runPulumiCmd(["whoami"]);
+                return { user: result.stdout.trim() };
+            }
+        });
+    }
+    /**
+     * Returns a summary of the currently selected stack, if any.
+     */
+    stack() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const stacks = yield this.listStacks();
+            for (const stack of stacks) {
+                if (stack.current) {
+                    return stack;
+                }
+            }
+            return undefined;
+        });
+    }
+    /**
+     * Returns all stacks from the underlying backend based on the provided
+     * options. This queries the underlying backend and may return stacks not
+     * present in the workspace as `Pulumi.<stack>.yaml` files.
+     *
+     * @param opts
+     *  Options to customize the behavior of the list.
+     */
+    listStacks(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["stack", "ls", "--json"];
+            if (opts) {
+                if (opts.all) {
+                    args.push("--all");
+                }
+            }
+            const result = yield this.runPulumiCmd(args);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Install plugin and language dependencies needed for the project.
+     *
+     * @param opts Options to customize the behavior of install.
+     */
+    install(opts) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let ver = this._pulumiVersion;
+            if (ver === undefined) {
+                ver = semver.parse("3.0.0");
+            }
+            if (ver.compare("3.91.0") < 0) {
+                // Pulumi 3.91.0 added the `pulumi install` command.
+                // https://github.com/pulumi/pulumi/releases/tag/v3.91.0
+                throw new Error(`pulumi install requires Pulumi version >= 3.91.0`);
+            }
+            const args = [];
+            if (opts === null || opts === void 0 ? void 0 : opts.useLanguageVersionTools) {
+                if (ver.compare("3.130.0") < 0) {
+                    // Pulumi 3.130.0 introduced the `--use-language-version-tools` flag.
+                    // https://github.com/pulumi/pulumi/releases/tag/v3.130.0
+                    throw new Error(`useLanguageVersionTools requires Pulumi version >= 3.130.0`);
+                }
+                args.push("--use-language-version-tools");
+            }
+            if (opts === null || opts === void 0 ? void 0 : opts.noPlugins) {
+                args.push("--no-plugins");
+            }
+            if (opts === null || opts === void 0 ? void 0 : opts.noDependencies) {
+                args.push("--no-dependencies");
+            }
+            if (opts === null || opts === void 0 ? void 0 : opts.reinstall) {
+                args.push("--reinstall");
+            }
+            yield this.runPulumiCmd(["install", ...args]);
+        });
+    }
+    /**
+     * Installs a plugin in the workspace, for example to use cloud providers
+     * like AWS or GCP.
+     *
+     * @param name
+     *  The name of the plugin.
+     * @param version
+     *  The version of the plugin e.g. "v1.0.0".
+     * @param kind
+     *  The kind of plugin, defaults to "resource"
+     */
+    installPlugin(name, version, kind = "resource") {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.runPulumiCmd(["plugin", "install", kind, name, version]);
+        });
+    }
+    /**
+     * Installs a plugin in the workspace from a third party server.
+     *
+     * @param name
+     *  The name of the plugin.
+     * @param version
+     *  The version of the plugin e.g. "v1.0.0".
+     * @param server
+     *  The server to install the plugin from
+     */
+    installPluginFromServer(name, version, server) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.runPulumiCmd(["plugin", "install", "resource", name, version, "--server", server]);
+        });
+    }
+    /**
+     * Removes a plugin from the workspace matching the specified name and version.
+     *
+     * @param name
+     *  The optional name of the plugin.
+     * @param versionRange
+     *  An optional semver range to check when removing plugins matching the
+     *  given name e.g. "1.0.0", ">1.0.0".
+     * @param kind
+     *  The kind of plugin, defaults to "resource".
+     */
+    removePlugin(name, versionRange, kind = "resource") {
+        return __awaiter(this, void 0, void 0, function* () {
+            const args = ["plugin", "rm", kind];
+            if (name) {
+                args.push(name);
+            }
+            if (versionRange) {
+                args.push(versionRange);
+            }
+            args.push("--yes");
+            yield this.runPulumiCmd(args);
+        });
+    }
+    /**
+     * Returns a list of all plugins installed in the workspace.
+     */
+    listPlugins() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.runPulumiCmd(["plugin", "ls", "--json"]);
+            return JSON.parse(result.stdout, (key, value) => {
+                if (key === "installTime" || key === "lastUsedTime") {
+                    return new Date(value);
+                }
+                return value;
+            });
+        });
+    }
+    /**
+     * Exports the deployment state of the stack. This can be combined with
+     * {@link importStack} to edit a stack's state (such as recovery from failed
+     * deployments).
+     *
+     * @param stackName
+     *  The name of the stack.
+     */
+    exportStack(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.runPulumiCmd(["stack", "export", "--show-secrets", "--stack", stackName]);
+            return JSON.parse(result.stdout);
+        });
+    }
+    /**
+     * Imports the given deployment state into a pre-existing stack. This can be
+     * combined with {@link exportStack} to edit a stack's state (such as
+     * recovery from failed deployments).
+     *
+     * @param stackName
+     *  The name of the stack.
+     * @param state
+     *  The stack state to import.
+     */
+    importStack(stackName, state) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const randomSuffix = Math.floor(100000 + Math.random() * 900000);
+            const filepath = upath.joinSafe(os.tmpdir(), `automation-${randomSuffix}`);
+            const contents = JSON.stringify(state, null, 4);
+            fs.writeFileSync(filepath, contents);
+            yield this.runPulumiCmd(["stack", "import", "--file", filepath, "--stack", stackName]);
+            fs.unlinkSync(filepath);
+        });
+    }
+    /**
+     * Gets the current set of Stack outputs from the last {@link Stack.up}.
+     *
+     * @param stackName The name of the stack.
+     */
+    stackOutputs(stackName) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // TODO: do this in parallel after this is fixed https://github.com/pulumi/pulumi/issues/6050
+            const maskedResult = yield this.runPulumiCmd(["stack", "output", "--json", "--stack", stackName]);
+            const plaintextResult = yield this.runPulumiCmd([
+                "stack",
+                "output",
+                "--json",
+                "--show-secrets",
+                "--stack",
+                stackName,
+            ]);
+            const maskedOuts = JSON.parse(maskedResult.stdout);
+            const plaintextOuts = JSON.parse(plaintextResult.stdout);
+            const outputs = {};
+            for (const [key, value] of Object.entries(plaintextOuts)) {
+                const secret = maskedOuts[key] === "[secret]";
+                outputs[key] = { value, secret };
+            }
+            return outputs;
+        });
+    }
+    /**
+     * A hook to provide additional args to every CLI commands before they are
+     * executed. Provided with stack name, this function returns a list of
+     * arguments to append to an invoked command (e.g. `["--config=...", ...]`)
+     * Presently, {@link LocalWorkspace} does not utilize this extensibility
+     * point.
+     */
+    serializeArgsForOp(_) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return [];
+        });
+    }
+    /**
+     * A hook executed after every command. Called with the stack name. An
+     * extensibility point to perform workspace cleanup (CLI operations may
+     * create/modify a `Pulumi.stack.yaml`) {@link LocalWorkspace} does not
+     * utilize this extensibility point.
+     */
+    postCommandCallback(_) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return;
+        });
+    }
+    checkRemoteSupport() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const optOut = !!this.envVars[SKIP_VERSION_CHECK_VAR] || !!process.env[SKIP_VERSION_CHECK_VAR];
+            // If remote was specified, ensure the CLI supports it.
+            if (!optOut && this.isRemote) {
+                // See if `--remote` is present in `pulumi preview --help`'s output.
+                const previewResult = yield this.runPulumiCmd(["preview", "--help"]);
+                const previewOutput = previewResult.stdout.trim();
+                if (!previewOutput.includes("--remote")) {
+                    throw new Error("The Pulumi CLI does not support remote operations. Please upgrade.");
+                }
+            }
+        });
+    }
+    runPulumiCmd(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            let envs = {};
+            if (this.pulumiHome) {
+                envs["PULUMI_HOME"] = this.pulumiHome;
+            }
+            if (this.isRemote) {
+                envs["PULUMI_EXPERIMENTAL"] = "true";
+            }
+            envs = Object.assign(Object.assign({}, envs), this.envVars);
+            return this.pulumiCommand.run(args, this.workDir, envs);
+        });
+    }
+    /**
+     * @internal
+     */
+    get isRemote() {
+        return !!this.remote;
+    }
+    /**
+     * @internal
+     */
+    remoteArgs() {
+        var _a, _b;
+        const args = [];
+        if (!this.isRemote) {
+            return args;
+        }
+        args.push("--remote");
+        if (this.remoteGitProgramArgs) {
+            const { url, projectPath, branch, commitHash, auth } = this.remoteGitProgramArgs;
+            if (url) {
+                args.push(url);
+            }
+            if (projectPath) {
+                args.push("--remote-git-repo-dir", projectPath);
+            }
+            if (branch) {
+                args.push("--remote-git-branch", branch);
+            }
+            if (commitHash) {
+                args.push("--remote-git-commit", commitHash);
+            }
+            if (auth) {
+                const { personalAccessToken, sshPrivateKey, sshPrivateKeyPath, password, username } = auth;
+                if (personalAccessToken) {
+                    args.push("--remote-git-auth-access-token", personalAccessToken);
+                }
+                if (sshPrivateKey) {
+                    args.push("--remote-git-auth-ssh-private-key", sshPrivateKey);
+                }
+                if (sshPrivateKeyPath) {
+                    args.push("--remote-git-auth-ssh-private-key-path", sshPrivateKeyPath);
+                }
+                if (password) {
+                    args.push("--remote-git-auth-password", password);
+                }
+                if (username) {
+                    args.push("--remote-git-auth-username", username);
+                }
+            }
+        }
+        for (const key of Object.keys((_a = this.remoteEnvVars) !== null && _a !== void 0 ? _a : {})) {
+            const val = this.remoteEnvVars[key];
+            if (typeof val === "string") {
+                args.push("--remote-env", `${key}=${val}`);
+            }
+            else if ("secret" in val) {
+                args.push("--remote-env-secret", `${key}=${val.secret}`);
+            }
+            else {
+                throw new Error(`unexpected env value '${val}' for key '${key}'`);
+            }
+        }
+        for (const command of (_b = this.remotePreRunCommands) !== null && _b !== void 0 ? _b : []) {
+            args.push("--remote-pre-run-command", command);
+        }
+        if (this.remoteSkipInstallDependencies) {
+            args.push("--remote-skip-install-dependencies");
+        }
+        if (this.remoteInheritSettings) {
+            args.push("--remote-inherit-settings");
+        }
+        return args;
+    }
+}
+exports.LocalWorkspace = LocalWorkspace;
+/**
+ * Returns true if the provided arguments satisfy the {@link LocalProgramArgs} interface.
+ *
+ * @param args
+ *  The args object to evaluate
+ */
+function isLocalProgramArgs(args) {
+    return args.workDir !== undefined;
+}
+/**
+ * Returns true if the provided arguments satisfy the {@link InlineProgramArgs} interface.
+ *
+ * @param args
+ *  The args object to evaluate
+ */
+function isInlineProgramArgs(args) {
+    return args.projectName !== undefined && args.program !== undefined;
+}
+const settingsExtensions = [".yaml", ".yml", ".json"];
+function getStackSettingsName(name) {
+    const parts = name.split("/");
+    if (parts.length < 1) {
+        return name;
+    }
+    return parts[parts.length - 1];
+}
+function defaultProject(projectName) {
+    const settings = { name: projectName, runtime: "nodejs", main: process.cwd() };
+    return settings;
+}
+function loadProjectSettings(workDir) {
+    for (const ext of settingsExtensions) {
+        const isJSON = ext === ".json";
+        const path = upath.joinSafe(workDir, `Pulumi${ext}`);
+        if (!fs.existsSync(path)) {
+            continue;
+        }
+        const contents = fs.readFileSync(path).toString();
+        if (isJSON) {
+            return JSON.parse(contents);
+        }
+        return yaml.safeLoad(contents);
+    }
+    throw new Error(`failed to find project settings file in workdir: ${workDir}`);
+}
+//# sourceMappingURL=localWorkspace.js.map