jsii-release 0.2.674 → 0.2.676

package/lib/codeartifact/usage-dir.d.ts

@@ -0,0 +1,55 @@
+export declare const DEFAULT_USAGE_DIR: string;
+/**
+ * The usage directory is where we write per-session config files to access the CodeArtifact repository.
+ *
+ * Some config files may be written in a system-global location, but they will not be active unless the
+ * contents of this directory have been sourced/copied into the current terminal.
+ *
+ * CONTRACT
+ *
+ * There are two special entries:
+ *
+ * - `env`, a file with `key=value` entries for environment variables to  set.
+ * - `cwd/`, a directory with files that need to be copied into the current directory before each command.
+ *
+ * Other than these, code may write tempfiles to this directory if it wants, but there is no meaning
+ * implied for other files.
+ */
+export declare class UsageDir {
+    readonly directory: string;
+    static default(): UsageDir;
+    readonly envFile: string;
+    readonly cwdDir: string;
+    private constructor();
+    delete(): Promise<void>;
+    /**
+     * Create a fresh empty directory, with helper scripts
+     */
+    reset(): Promise<void>;
+    /**
+     * Set the expiration time of the current settings
+     */
+    setExpirationTimeMs(timestamp: number): Promise<void>;
+    /**
+     * Add settings to the environment variables
+     */
+    addToEnv(settings: Record<string, string>): Promise<void>;
+    /**
+     * Return the current environment variables
+     */
+    currentEnv(): Promise<Record<string, string>>;
+    cwdFile(filename: string): string;
+    /**
+     * Activate in the current process (update process.env), copy the cwd/ directory to the current directory
+     */
+    activateInCurrentProcess(): Promise<void>;
+    copySelectCwdFileHere(...filenames: string[]): Promise<void>;
+    putFile(filename: string, contents: string): Promise<string>;
+    putCwdFile(filename: string, contents: string): Promise<void>;
+    putJson(key: string, data: any): Promise<void>;
+    readJson<A>(key: string): Promise<A | undefined>;
+    /**
+     * Print to the console on how to activate these settings
+     */
+    advertise(): void;
+}

package/lib/codeartifact/usage-dir.js

@@ -0,0 +1,160 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UsageDir = exports.DEFAULT_USAGE_DIR = void 0;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs-extra"));
+const files_1 = require("./files");
+exports.DEFAULT_USAGE_DIR = path.join((0, files_1.homeDir)(), '.publib-ca/usage');
+/**
+ * The usage directory is where we write per-session config files to access the CodeArtifact repository.
+ *
+ * Some config files may be written in a system-global location, but they will not be active unless the
+ * contents of this directory have been sourced/copied into the current terminal.
+ *
+ * CONTRACT
+ *
+ * There are two special entries:
+ *
+ * - `env`, a file with `key=value` entries for environment variables to  set.
+ * - `cwd/`, a directory with files that need to be copied into the current directory before each command.
+ *
+ * Other than these, code may write tempfiles to this directory if it wants, but there is no meaning
+ * implied for other files.
+ */
+class UsageDir {
+    static default() {
+        return new UsageDir(exports.DEFAULT_USAGE_DIR);
+    }
+    constructor(directory) {
+        this.directory = directory;
+        this.envFile = path.join(this.directory, 'env');
+        this.cwdDir = path.join(this.directory, 'cwd');
+    }
+    async delete() {
+        if (await fs.pathExists(this.directory)) {
+            await fs.remove(this.directory);
+        }
+    }
+    /**
+     * Create a fresh empty directory, with helper scripts
+     */
+    async reset() {
+        await this.delete();
+        await fs.mkdirp(path.join(this.directory, 'cwd'));
+        await fs.writeFile(path.join(this.directory, 'env'), '', { encoding: 'utf-8' });
+        await this.addToEnv({
+            CWD_FILES_DIR: path.join(this.directory, 'cwd'),
+        });
+        // Write a bash helper to load these settings
+        await fs.writeFile(path.join(this.directory, 'activate.bash'), [
+            `while read -u10 line; do [[ -z $line ]] || export "$line"; done 10<${this.directory}/env`,
+            'cp -R $CWD_FILES_DIR/ .', // Copy files from directory even if it is empty
+        ].join('\n'), { encoding: 'utf-8' });
+    }
+    /**
+     * Set the expiration time of the current settings
+     */
+    async setExpirationTimeMs(timestamp) {
+        await this.addToEnv({
+            EXPIRATION_TIME_MS: `${timestamp}`,
+        });
+    }
+    /**
+     * Add settings to the environment variables
+     */
+    async addToEnv(settings) {
+        const lines = await (0, files_1.loadLines)(this.envFile);
+        for (const [k, v] of Object.entries(settings)) {
+            (0, files_1.updateIniKey)(lines, k, v);
+        }
+        await (0, files_1.writeLines)(this.envFile, lines);
+    }
+    /**
+     * Return the current environment variables
+     */
+    async currentEnv() {
+        const lines = await (0, files_1.loadLines)(this.envFile);
+        const splitter = /^([a-zA-Z0-9_-]+)\s*=\s*(.*)$/;
+        const ret = {};
+        for (const line of lines) {
+            const m = line.match(splitter);
+            if (m) {
+                ret[m[1]] = m[2];
+            }
+        }
+        return ret;
+    }
+    cwdFile(filename) {
+        return path.join(this.cwdDir, filename);
+    }
+    /**
+     * Activate in the current process (update process.env), copy the cwd/ directory to the current directory
+     */
+    async activateInCurrentProcess() {
+        for (const [k, v] of Object.entries(await this.currentEnv())) {
+            process.env[k] = v;
+        }
+        await (0, files_1.copyDirectoryContents)(this.cwdDir, '.');
+    }
+    async copySelectCwdFileHere(...filenames) {
+        for (const file of filenames) {
+            await fs.copyFile(path.join(this.cwdDir, file), file);
+        }
+    }
+    async putFile(filename, contents) {
+        const fileName = path.join(this.directory, filename);
+        await (0, files_1.writeFile)(fileName, contents);
+        return fileName;
+    }
+    async putCwdFile(filename, contents) {
+        await (0, files_1.writeFile)(path.join(this.cwdDir, filename), contents);
+    }
+    async putJson(key, data) {
+        await (0, files_1.writeFile)(path.join(this.directory, key + '.json'), JSON.stringify(data, undefined, 2));
+    }
+    async readJson(key) {
+        try {
+            return await fs.readJson(path.join(this.directory, key + '.json'));
+        }
+        catch (e) {
+            if (e.code === 'ENOENT') {
+                return undefined;
+            }
+            throw e;
+        }
+    }
+    /**
+     * Print to the console on how to activate these settings
+     */
+    advertise() {
+        // eslint-disable-next-line no-console
+        console.log('To activate these settings in the current bash shell:');
+        // eslint-disable-next-line no-console
+        console.log(`    source ${this.directory}/activate.bash`);
+    }
+}
+exports.UsageDir = UsageDir;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXNhZ2UtZGlyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvZGVhcnRpZmFjdC91c2FnZS1kaXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSwyQ0FBNkI7QUFDN0IsNkNBQStCO0FBQy9CLG1DQUF5RztBQUU1RixRQUFBLGlCQUFpQixHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBQSxlQUFPLEdBQUUsRUFBRSxrQkFBa0IsQ0FBQyxDQUFDO0FBRTFFOzs7Ozs7Ozs7Ozs7Ozs7R0FlRztBQUNILE1BQWEsUUFBUTtJQUNaLE1BQU0sQ0FBQyxPQUFPO1FBQ25CLE9BQU8sSUFBSSxRQUFRLENBQUMseUJBQWlCLENBQUMsQ0FBQztJQUN6QyxDQUFDO0lBS0QsWUFBb0MsU0FBaUI7UUFBakIsY0FBUyxHQUFULFNBQVMsQ0FBUTtRQUNuRCxJQUFJLENBQUMsT0FBTyxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztRQUNoRCxJQUFJLENBQUMsTUFBTSxHQUFHLElBQUksQ0FBQyxJQUFJLENBQUMsSUFBSSxDQUFDLFNBQVMsRUFBRSxLQUFLLENBQUMsQ0FBQztJQUNqRCxDQUFDO0lBRU0sS0FBSyxDQUFDLE1BQU07UUFDakIsSUFBSSxNQUFNLEVBQUUsQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLFNBQVMsQ0FBQyxFQUFFO1lBQ3ZDLE1BQU0sRUFBRSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLENBQUM7U0FDakM7SUFDSCxDQUFDO0lBRUQ7O09BRUc7SUFDSSxLQUFLLENBQUMsS0FBSztRQUNoQixNQUFNLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUNwQixNQUFNLEVBQUUsQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsU0FBUyxFQUFFLEtBQUssQ0FBQyxD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LENBQUM7U0FDVDtJQUNILENBQUM7SUFFRDs7T0FFRztJQUNJLFNBQVM7UUFDZCxzQ0FBc0M7UUFDdEMsT0FBTyxDQUFDLEdBQUcsQ0FBQyx1REFBdUQsQ0FBQyxDQUFDO1FBQ3JFLHNDQUFzQztRQUN0QyxPQUFPLENBQUMsR0FBRyxDQUFDLGNBQWMsSUFBSSxDQUFDLFNBQVMsZ0JBQWdCLENBQUMsQ0FBQztJQUM1RCxDQUFDO0NBQ0Y7QUFwSUQsNEJBb0lDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCAqIGFzIGZzIGZyb20gJ2ZzLWV4dHJhJztcbmltcG9ydCB7IGNvcHlEaXJlY3RvcnlDb250ZW50cywgaG9tZURpciwgbG9hZExpbmVzLCB1cGRhdGVJbmlLZXksIHdyaXRlRmlsZSwgd3JpdGVMaW5lcyB9IGZyb20gJy4vZmlsZXMnO1xuXG5leHBvcnQgY29uc3QgREVGQVVMVF9VU0FHRV9ESVIgPSBwYXRoLmpvaW4oaG9tZURpcigpLCAnLnB1YmxpYi1jYS91c2FnZScpO1xuXG4vKipcbiAqIFRoZSB1c2FnZSBkaXJlY3RvcnkgaXMgd2hlcmUgd2Ugd3JpdGUgcGVyLXNlc3Npb24gY29uZmlnIGZpbGVzIHRvIGFjY2VzcyB0aGUgQ29kZUFydGlmYWN0IHJlcG9zaXRvcnkuXG4gKlxuICogU29tZSBjb25maWcgZmlsZXMgbWF5IGJlIHdyaXR0ZW4gaW4gYSBzeXN0ZW0tZ2xvYmFsIGxvY2F0aW9uLCBidXQgdGhleSB3aWxsIG5vdCBiZSBhY3RpdmUgdW5sZXNzIHRoZVxuICogY29udGVudHMgb2YgdGhpcyBkaXJlY3RvcnkgaGF2ZSBiZWVuIHNvdXJjZWQvY29waWVkIGludG8gdGhlIGN1cnJlbnQgdGVybWluYWwuXG4gKlxuICogQ09OVFJBQ1RcbiAqXG4gKiBUaGVyZSBhcmUgdHdvIHNwZWNpYWwgZW50cmllczpcbiAqXG4gKiAtIGBlbnZgLCBhIGZpbGUgd2l0aCBga2V5PXZhbHVlYCBlbnRyaWVzIGZvciBlbnZpcm9ubWVudCB2YXJpYWJsZXMgdG8gIHNldC5cbiAqIC0gYGN3ZC9gLCBhIGRpcmVjdG9yeSB3aXRoIGZpbGVzIHRoYXQgbmVlZCB0byBiZSBjb3BpZWQgaW50byB0aGUgY3VycmVudCBkaXJlY3RvcnkgYmVmb3JlIGVhY2ggY29tbWFuZC5cbiAqXG4gKiBPdGhlciB0aGFuIHRoZXNlLCBjb2RlIG1heSB3cml0ZSB0ZW1wZmlsZXMgdG8gdGhpcyBkaXJlY3RvcnkgaWYgaXQgd2FudHMsIGJ1dCB0aGVyZSBpcyBubyBtZWFuaW5nXG4gKiBpbXBsaWVkIGZvciBvdGhlciBmaWxlcy5cbiAqL1xuZXhwb3J0IGNsYXNzIFVzYWdlRGlyIHtcbiAgcHVibGljIHN0YXRpYyBkZWZhdWx0KCkge1xuICAgIHJldHVybiBuZXcgVXNhZ2VEaXIoREVGQVVMVF9VU0FHRV9ESVIpO1xuICB9XG5cbiAgcHVibGljIHJlYWRvbmx5IGVudkZpbGU6IHN0cmluZztcbiAgcHVibGljIHJlYWRvbmx5IGN3ZERpcjogc3RyaW5nO1xuXG4gIHByaXZhdGUgY29uc3RydWN0b3IocHVibGljIHJlYWRvbmx5IGRpcmVjdG9yeTogc3RyaW5nKSB7XG4gICAgdGhpcy5lbnZGaWxlID0gcGF0aC5qb2luKHRoaXMuZGlyZWN0b3J5LCAnZW52Jyk7XG4gICAgdGhpcy5jd2REaXIgPSBwYXRoLmpvaW4odGhpcy5kaXJlY3RvcnksICdjd2QnKTtcbiAgfVxuXG4gIHB1YmxpYyBhc3luYyBkZWxldGUoKSB7XG4gICAgaWYgKGF3YWl0IGZzLnBhdGhFeGlzdHModGhpcy5kaXJlY3RvcnkpKSB7XG4gICAgICBhd2FpdCBmcy5yZW1vdmUodGhpcy5kaXJlY3RvcnkpO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBDcmVhdGUgYSBmcmVzaCBlbXB0eSBkaXJlY3RvcnksIHdpdGggaGVscGVyIHNjcmlwdHNcbiAgICovXG4gIHB1YmxpYyBhc3luYyByZXNldCgpIHtcbiAgICBhd2FpdCB0aGlzLmRlbGV0ZSgpO1xuICAgIGF3YWl0IGZzLm1rZGlycChwYXRoLmpvaW4odGhpcy5kaXJlY3RvcnksICdjd2QnKSk7XG4gICAgYXdhaXQgZnMud3JpdGVGaWxlKHBhdGguam9pbih0aGlzLmRpcmVjdG9yeSwgJ2VudicpLCAnJywgeyBlbmNvZGluZzogJ3V0Zi04JyB9KTtcblxuICAgIGF3YWl0IHRoaXMuYWRkVG9FbnYoe1xuICAgICAgQ1dEX0ZJTEVTX0RJUjogcGF0aC5qb2luKHRoaXMuZGlyZWN0b3J5LCAnY3dkJyksXG4gICAgfSk7XG5cbiAgICAvLyBXcml0ZSBhIGJhc2ggaGVscGVyIHRvIGxvYWQgdGhlc2Ugc2V0dGluZ3NcbiAgICBhd2FpdCBmcy53cml0ZUZpbGUocGF0aC5qb2luKHRoaXMuZGlyZWN0b3J5LCAnYWN0aXZhdGUuYmFzaCcpLCBbXG4gICAgICBgd2hpbGUgcmVhZCAtdTEwIGxpbmU7IGRvIFtbIC16ICRsaW5lIF1dIHx8IGV4cG9ydCBcIiRsaW5lXCI7IGRvbmUgMTA8JHt0aGlzLmRpcmVjdG9yeX0vZW52YCxcbiAgICAgICdjcCAtUiAkQ1dEX0ZJTEVTX0RJUi8gLicsIC8vIENvcHkgZmlsZXMgZnJvbSBkaXJlY3RvcnkgZXZlbiBpZiBpdCBpcyBlbXB0eVxuICAgIF0uam9pbignXFxuJyksIHsgZW5jb2Rpbmc6ICd1dGYtOCcgfSk7XG4gIH1cblxuICAvKipcbiAgICogU2V0IHRoZSBleHBpcmF0aW9uIHRpbWUgb2YgdGhlIGN1cnJlbnQgc2V0dGluZ3NcbiAgICovXG4gIHB1YmxpYyBhc3luYyBzZXRFeHBpcmF0aW9uVGltZU1zKHRpbWVzdGFtcDogbnVtYmVyKSB7XG4gICAgYXdhaXQgdGhpcy5hZGRUb0Vudih7XG4gICAgICBFWFBJUkFUSU9OX1RJTUVfTVM6IGAke3RpbWVzdGFtcH1gLFxuICAgIH0pO1xuICB9XG5cbiAgLyoqXG4gICAqIEFkZCBzZXR0aW5ncyB0byB0aGUgZW52aXJvbm1lbnQgdmFyaWFibGVzXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgYWRkVG9FbnYoc2V0dGluZ3M6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4pIHtcbiAgICBjb25zdCBsaW5lcyA9IGF3YWl0IGxvYWRMaW5lcyh0aGlzLmVudkZpbGUpO1xuICAgIGZvciAoY29uc3QgW2ssIHZdIG9mIE9iamVjdC5lbnRyaWVzKHNldHRpbmdzKSkge1xuICAgICAgdXBkYXRlSW5pS2V5KGxpbmVzLCBrLCB2KTtcbiAgICB9XG4gICAgYXdhaXQgd3JpdGVMaW5lcyh0aGlzLmVudkZpbGUsIGxpbmVzKTtcbiAgfVxuXG4gIC8qKlxuICAgKiBSZXR1cm4gdGhlIGN1cnJlbnQgZW52aXJvbm1lbnQgdmFyaWFibGVzXG4gICAqL1xuICBwdWJsaWMgYXN5bmMgY3VycmVudEVudigpOiBQcm9taXNlPFJlY29yZDxzdHJpbmcsIHN0cmluZz4+IHtcbiAgICBjb25zdCBsaW5lcyA9IGF3YWl0IGxvYWRMaW5lcyh0aGlzLmVudkZpbGUpO1xuXG4gICAgY29uc3Qgc3BsaXR0ZXIgPSAvXihbYS16QS1aMC05Xy1dKylcXHMqPVxccyooLiopJC87XG5cbiAgICBjb25zdCByZXQ6IFJlY29yZDxzdHJpbmcsIHN0cmluZz4gPSB7fTtcbiAgICBmb3IgKGNvbnN0IGxpbmUgb2YgbGluZXMpIHtcbiAgICAgIGNvbnN0IG0gPSBsaW5lLm1hdGNoKHNwbGl0dGVyKTtcbiAgICAgIGlmIChtKSB7XG4gICAgICAgIHJldFttWzFdXSA9IG1bMl07XG4gICAgICB9XG4gICAgfVxuICAgIHJldHVybiByZXQ7XG4gIH1cblxuICBwdWJsaWMgY3dkRmlsZShmaWxlbmFtZTogc3RyaW5nKSB7XG4gICAgcmV0dXJuIHBhdGguam9pbih0aGlzLmN3ZERpciwgZmlsZW5hbWUpO1xuICB9XG5cbiAgLyoqXG4gICAqIEFjdGl2YXRlIGluIHRoZSBjdXJyZW50IHByb2Nlc3MgKHVwZGF0ZSBwcm9jZXNzLmVudiksIGNvcHkgdGhlIGN3ZC8gZGlyZWN0b3J5IHRvIHRoZSBjdXJyZW50IGRpcmVjdG9yeVxuICAgKi9cbiAgcHVibGljIGFzeW5jIGFjdGl2YXRlSW5DdXJyZW50UHJvY2VzcygpIHtcbiAgICBmb3IgKGNvbnN0IFtrLCB2XSBvZiBPYmplY3QuZW50cmllcyhhd2FpdCB0aGlzLmN1cnJlbnRFbnYoKSkpIHtcbiAgICAgIHByb2Nlc3MuZW52W2tdID0gdjtcbiAgICB9XG5cbiAgICBhd2FpdCBjb3B5RGlyZWN0b3J5Q29udGVudHModGhpcy5jd2REaXIsICcuJyk7XG4gIH1cblxuICBwdWJsaWMgYXN5bmMgY29weVNlbGVjdEN3ZEZpbGVIZXJlKC4uLmZpbGVuYW1lczogc3RyaW5nW10pIHtcbiAgICBmb3IgKGNvbnN0IGZpbGUgb2YgZmlsZW5hbWVzKSB7XG4gICAgICBhd2FpdCBmcy5jb3B5RmlsZShwYXRoLmpvaW4odGhpcy5jd2REaXIsIGZpbGUpLCBmaWxlKTtcbiAgICB9XG4gIH1cblxuICBwdWJsaWMgYXN5bmMgcHV0RmlsZShmaWxlbmFtZTogc3RyaW5nLCBjb250ZW50czogc3RyaW5nKSB7XG4gICAgY29uc3QgZmlsZU5hbWUgPSBwYXRoLmpvaW4odGhpcy5kaXJlY3RvcnksIGZpbGVuYW1lKTtcbiAgICBhd2FpdCB3cml0ZUZpbGUoZmlsZU5hbWUsIGNvbnRlbnRzKTtcbiAgICByZXR1cm4gZmlsZU5hbWU7XG4gIH1cblxuICBwdWJsaWMgYXN5bmMgcHV0Q3dkRmlsZShmaWxlbmFtZTogc3RyaW5nLCBjb250ZW50czogc3RyaW5nKSB7XG4gICAgYXdhaXQgd3JpdGVGaWxlKHBhdGguam9pbih0aGlzLmN3ZERpciwgZmlsZW5hbWUpLCBjb250ZW50cyk7XG4gIH1cblxuICBwdWJsaWMgYXN5bmMgcHV0SnNvbihrZXk6IHN0cmluZywgZGF0YTogYW55KSB7XG4gICAgYXdhaXQgd3JpdGVGaWxlKHBhdGguam9pbih0aGlzLmRpcmVjdG9yeSwga2V5ICsgJy5qc29uJyksIEpTT04uc3RyaW5naWZ5KGRhdGEsIHVuZGVmaW5lZCwgMikpO1xuICB9XG5cbiAgcHVibGljIGFzeW5jIHJlYWRKc29uPEE+KGtleTogc3RyaW5nKTogUHJvbWlzZTxBIHwgdW5kZWZpbmVkPiB7XG4gICAgdHJ5IHtcbiAgICAgIHJldHVybiBhd2FpdCBmcy5yZWFkSnNvbihwYXRoLmpvaW4odGhpcy5kaXJlY3RvcnksIGtleSArICcuanNvbicpKTtcbiAgICB9IGNhdGNoIChlOiBhbnkpIHtcbiAgICAgIGlmIChlLmNvZGUgPT09ICdFTk9FTlQnKSB7XG4gICAgICAgIHJldHVybiB1bmRlZmluZWQ7XG4gICAgICB9XG5cbiAgICAgIHRocm93IGU7XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFByaW50IHRvIHRoZSBjb25zb2xlIG9uIGhvdyB0byBhY3RpdmF0ZSB0aGVzZSBzZXR0aW5nc1xuICAgKi9cbiAgcHVibGljIGFkdmVydGlzZSgpIHtcbiAgICAvLyBlc2xpbnQtZGlzYWJsZS1uZXh0LWxpbmUgbm8tY29uc29sZVxuICAgIGNvbnNvbGUubG9nKCdUbyBhY3RpdmF0ZSB0aGVzZSBzZXR0aW5ncyBpbiB0aGUgY3VycmVudCBiYXNoIHNoZWxsOicpO1xuICAgIC8vIGVzbGludC1kaXNhYmxlLW5leHQtbGluZSBuby1jb25zb2xlXG4gICAgY29uc29sZS5sb2coYCAgICBzb3VyY2UgJHt0aGlzLmRpcmVjdG9yeX0vYWN0aXZhdGUuYmFzaGApO1xuICB9XG59Il19

package/lib/help/corking.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="node" />
+/// <reference types="node" />
+/// <reference types="node" />
+/**
+ * Routines for corking stdout and stderr
+ */
+import * as stream from 'stream';
+export declare class MemoryStream extends stream.Writable {
+    private parts;
+    _write(chunk: Buffer, _encoding: string, callback: (error?: Error | null) => void): void;
+    buffer(): Buffer;
+    clear(): void;
+    flushTo(strm: NodeJS.WritableStream): Promise<unknown>;
+    toString(): string;
+}

package/lib/help/corking.js

@@ -0,0 +1,57 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MemoryStream = void 0;
+/**
+ * Routines for corking stdout and stderr
+ */
+const stream = __importStar(require("stream"));
+class MemoryStream extends stream.Writable {
+    constructor() {
+        super(...arguments);
+        this.parts = new Array();
+    }
+    _write(chunk, _encoding, callback) {
+        this.parts.push(chunk);
+        callback();
+    }
+    buffer() {
+        return Buffer.concat(this.parts);
+    }
+    clear() {
+        this.parts.splice(0, this.parts.length);
+    }
+    async flushTo(strm) {
+        const flushed = strm.write(this.buffer());
+        if (!flushed) {
+            return new Promise(ok => strm.once('drain', ok));
+        }
+    }
+    toString() {
+        return this.buffer().toString();
+    }
+}
+exports.MemoryStream = MemoryStream;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29ya2luZy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9oZWxwL2NvcmtpbmcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQTs7R0FFRztBQUNILCtDQUFpQztBQUVqQyxNQUFhLFlBQWEsU0FBUSxNQUFNLENBQUMsUUFBUTtJQUFqRDs7UUFDVSxVQUFLLEdBQUcsSUFBSSxLQUFLLEVBQVUsQ0FBQztJQXlCdEMsQ0FBQztJQXZCUSxNQUFNLENBQUMsS0FBYSxFQUFFLFNBQWlCLEVBQUUsUUFBd0M7UUFDdEYsSUFBSSxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7UUFDdkIsUUFBUSxFQUFFLENBQUM7SUFDYixDQUFDO0lBRU0sTUFBTTtRQUNYLE9BQU8sTUFBTSxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDbkMsQ0FBQztJQUVNLEtBQUs7UUFDVixJQUFJLENBQUMsS0FBSyxDQUFDLE1BQU0sQ0FBQyxDQUFDLEVBQUUsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUMxQyxDQUFDO0lBRU0sS0FBSyxDQUFDLE9BQU8sQ0FBQyxJQUEyQjtRQUM5QyxNQUFNLE9BQU8sR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxNQUFNLEVBQUUsQ0FBQyxDQUFDO1FBQzFDLElBQUksQ0FBQyxPQUFPLEVBQUU7WUFDWixPQUFPLElBQUksT0FBTyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsSUFBSSxDQUFDLElBQUksQ0FBQyxPQUFPLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztTQUNsRDtJQUNILENBQUM7SUFFTSxRQUFRO1FBQ2IsT0FBTyxJQUFJLENBQUMsTUFBTSxFQUFFLENBQUMsUUFBUSxFQUFFLENBQUM7SUFDbEMsQ0FBQztDQUNGO0FBMUJELG9DQTBCQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUm91dGluZXMgZm9yIGNvcmtpbmcgc3Rkb3V0IGFuZCBzdGRlcnJcbiAqL1xuaW1wb3J0ICogYXMgc3RyZWFtIGZyb20gJ3N0cmVhbSc7XG5cbmV4cG9ydCBjbGFzcyBNZW1vcnlTdHJlYW0gZXh0ZW5kcyBzdHJlYW0uV3JpdGFibGUge1xuICBwcml2YXRlIHBhcnRzID0gbmV3IEFycmF5PEJ1ZmZlcj4oKTtcblxuICBwdWJsaWMgX3dyaXRlKGNodW5rOiBCdWZmZXIsIF9lbmNvZGluZzogc3RyaW5nLCBjYWxsYmFjazogKGVycm9yPzogRXJyb3IgfCBudWxsKSA9PiB2b2lkKTogdm9pZCB7XG4gICAgdGhpcy5wYXJ0cy5wdXNoKGNodW5rKTtcbiAgICBjYWxsYmFjaygpO1xuICB9XG5cbiAgcHVibGljIGJ1ZmZlcigpIHtcbiAgICByZXR1cm4gQnVmZmVyLmNvbmNhdCh0aGlzLnBhcnRzKTtcbiAgfVxuXG4gIHB1YmxpYyBjbGVhcigpIHtcbiAgICB0aGlzLnBhcnRzLnNwbGljZSgwLCB0aGlzLnBhcnRzLmxlbmd0aCk7XG4gIH1cblxuICBwdWJsaWMgYXN5bmMgZmx1c2hUbyhzdHJtOiBOb2RlSlMuV3JpdGFibGVTdHJlYW0pIHtcbiAgICBjb25zdCBmbHVzaGVkID0gc3RybS53cml0ZSh0aGlzLmJ1ZmZlcigpKTtcbiAgICBpZiAoIWZsdXNoZWQpIHtcbiAgICAgIHJldHVybiBuZXcgUHJvbWlzZShvayA9PiBzdHJtLm9uY2UoJ2RyYWluJywgb2spKTtcbiAgICB9XG4gIH1cblxuICBwdWJsaWMgdG9TdHJpbmcoKSB7XG4gICAgcmV0dXJuIHRoaXMuYnVmZmVyKCkudG9TdHJpbmcoKTtcbiAgfVxufVxuIl19

package/lib/help/shell.d.ts

@@ -20,6 +20,10 @@ export interface RunOptions {
      * @default false
      */
     readonly shell?: boolean;
+    /**
+     * Properties to add to 'env'
+     */
+    readonly modEnv?: Record<string, string>;
 }
 /**
  * Run a shell command and return the output.

package/lib/help/shell.js

@@ -36,10 +36,12 @@ function run(command, options = {}) {
     var _a, _b, _c;
     const shsplit = shlex.split(command);
     const pipeOrInherit = ((_a = options.capture) !== null && _a !== void 0 ? _a : false) ? 'pipe' : 'inherit';
+    const env = { ...process.env, ...options.modEnv };
     const result = child.spawnSync(shsplit[0], shsplit.slice(1), {
         stdio: ['ignore', pipeOrInherit, pipeOrInherit],
         cwd: options.cwd,
         shell: options.shell,
+        env,
     });
     if (result.error) {
         throw result.error;
@@ -50,7 +52,7 @@ function run(command, options = {}) {
         const message = `
     Command failed: ${command}.
       Output: ${stdout}
-      Error:${stderr}`;
+      Error: ${stderr}`;
         throw new Error(message);
     }
     return stdout;
@@ -71,4 +73,4 @@ function which(program) {
     }
 }
 exports.which = which;
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hlbGwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaGVscC9zaGVsbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHFEQUF1QztBQUN2Qyw2Q0FBK0I7QUE2Qi9COzs7OztHQUtHO0FBQ0gsU0FBZ0IsR0FBRyxDQUFDLE9BQWUsRUFBRSxVQUFzQixFQUFFOztJQUMzRCxNQUFNLE9BQU8sR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3JDLE1BQU0sYUFBYSxHQUFHLENBQUMsTUFBQSxPQUFPLENBQUMsT0FBTyxtQ0FBSSxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFBLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDckUsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRTtRQUMzRCxLQUFLLEVBQUUsQ0FBQyxRQUFRLEVBQUUsYUFBYSxFQUFFLGFBQWEsQ0FBQztRQUMvQyxHQUFHLEVBQUUsT0FBTyxDQUFDLEdBQUc7UUFDaEIsS0FBSyxFQUFFLE9BQU8sQ0FBQyxLQUFLO0tBQ3JCLENBQUMsQ0FBQztJQUNILElBQUksTUFBTSxDQUFDLEtBQUssRUFBRTtRQUNoQixNQUFNLE1BQU0sQ0FBQyxLQUFLLENBQUM7S0FDcEI7SUFFRCxNQUFNLE1BQU0sR0FBRyxNQUFBLE1BQU0sQ0FBQyxNQUFNLDBDQUFFLFFBQVEsRUFBRSxDQUFDO0lBQ3pDLE1BQU0sTUFBTSxHQUFHLE1BQUEsTUFBTSxDQUFDLE1BQU0sMENBQUUsUUFBUSxFQUFFLENBQUM7SUFFekMsSUFBSSxNQUFNLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRTtRQUN2QixNQUFNLE9BQU8sR0FBRztzQkFDRSxPQUFPO2dCQUNiLE1BQU07Y0FDUixNQUFNLEVBQUUsQ0FBQztRQUNuQixNQUFNLElBQUksS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0tBQzFCO0lBQ0QsT0FBTyxNQUFNLENBQUM7QUFDaEIsQ0FBQztBQXZCRCxrQkF1QkM7QUFFRDs7Ozs7R0FLRztBQUNILFNBQWdCLEtBQUssQ0FBQyxPQUFlO0lBQ25DLElBQUk7UUFDRixPQUFPLEdBQUcsQ0FBQyxTQUFTLE9BQU8sRUFBRSxFQUFFLEVBQUUsT0FBTyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7S0FDbkQ7SUFBQyxPQUFPLEdBQUcsRUFBRTtRQUNaLE9BQU8sRUFBRSxDQUFDO0tBQ1g7QUFDSCxDQUFDO0FBTkQsc0JBTUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBjaGlsZCBmcm9tICdjaGlsZF9wcm9jZXNzJztcbmltcG9ydCAqIGFzIHNobGV4IGZyb20gJ3NobGV4JztcblxuLyoqXG4gKiBPcHRpb25zIGZvciB0aGUgYHJ1bmAgZnVuY3Rpb24uXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUnVuT3B0aW9ucyB7XG5cbiAgLyoqXG4gICAqIFdva3JpbmcgZGlyZWN0b3J5LlxuICAgKlxuICAgKiBAZGVmYXVsdCBwcm9jZXNzLmN3ZCgpXG4gICAqL1xuICByZWFkb25seSBjd2Q/OiBzdHJpbmc7XG5cbiAgLyoqXG4gICAqIENhcHR1cmUgdGhlIG91dHB1dCBvZiB0aGUgY29tbWFuZCBhbmQgcmV0dXJuIHRvIGNhbGxlci5cbiAgICpcbiAgICogQGRlZmF1bHQgLSBubyBjYXB0dXJlLCBvdXRwdXQgaXMgcHJpbnRlZCB0byBzdGRvdXQuXG4gICAqL1xuICByZWFkb25seSBjYXB0dXJlPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogUnVuIHRoZSBjb21tYW5kIGluc2lkZSBhIHNoZWxsLlxuICAgKlxuICAgKiBAZGVmYXVsdCBmYWxzZVxuICAgKi9cbiAgcmVhZG9ubHkgc2hlbGw/OiBib29sZWFuO1xufVxuXG4vKipcbiAqIFJ1biBhIHNoZWxsIGNvbW1hbmQgYW5kIHJldHVybiB0aGUgb3V0cHV0LlxuICogVGhyb3dzIGlmIHRoZSBjb21tYW5kIGZhaWxzLlxuICpcbiAqIEBwYXJhbSBjb21tYW5kIGNvbW1hbmQgKGUuZyAnZ2l0IGNvbW1pdCAtbScpXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBydW4oY29tbWFuZDogc3RyaW5nLCBvcHRpb25zOiBSdW5PcHRpb25zID0ge30pOiBzdHJpbmcge1xuICBjb25zdCBzaHNwbGl0ID0gc2hsZXguc3BsaXQoY29tbWFuZCk7XG4gIGNvbnN0IHBpcGVPckluaGVyaXQgPSAob3B0aW9ucy5jYXB0dXJlID8/IGZhbHNlKSA/ICdwaXBlJzogJ2luaGVyaXQnO1xuICBjb25zdCByZXN1bHQgPSBjaGlsZC5zcGF3blN5bmMoc2hzcGxpdFswXSwgc2hzcGxpdC5zbGljZSgxKSwge1xuICAgIHN0ZGlvOiBbJ2lnbm9yZScsIHBpcGVPckluaGVyaXQsIHBpcGVPckluaGVyaXRdLFxuICAgIGN3ZDogb3B0aW9ucy5jd2QsXG4gICAgc2hlbGw6IG9wdGlvbnMuc2hlbGwsXG4gIH0pO1xuICBpZiAocmVzdWx0LmVycm9yKSB7XG4gICAgdGhyb3cgcmVzdWx0LmVycm9yO1xuICB9XG5cbiAgY29uc3Qgc3Rkb3V0ID0gcmVzdWx0LnN0ZG91dD8udG9TdHJpbmcoKTtcbiAgY29uc3Qgc3RkZXJyID0gcmVzdWx0LnN0ZGVycj8udG9TdHJpbmcoKTtcblxuICBpZiAocmVzdWx0LnN0YXR1cyAhPT0gMCkge1xuICAgIGNvbnN0IG1lc3NhZ2UgPSBgXG4gICAgQ29tbWFuZCBmYWlsZWQ6ICR7Y29tbWFuZH0uXG4gICAgICBPdXRwdXQ6ICR7c3Rkb3V0fVxuICAgICAgRXJyb3I6JHtzdGRlcnJ9YDtcbiAgICB0aHJvdyBuZXcgRXJyb3IobWVzc2FnZSk7XG4gIH1cbiAgcmV0dXJuIHN0ZG91dDtcbn1cblxuLyoqXG4gKiBSZXR1cm4gdGhlIHBhdGggdW5kZXIgd2hpY2ggYSBwcm9ncmFtIGlzIGF2YWlsYWJsZS5cbiAqIEVtcHR5IHN0cmluZyBpZiB0aGUgcHJvZ3JhbSBpcyBub3QgaW5zdGFsbGVkLlxuICpcbiAqIEBwYXJhbSBwcm9ncmFtIHByb2dyYW0gdG8gY2hlY2sgKGUuZyAnZ2l0JylcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHdoaWNoKHByb2dyYW06IHN0cmluZyk6IHN0cmluZyB7XG4gIHRyeSB7XG4gICAgcmV0dXJuIHJ1bihgd2hpY2ggJHtwcm9ncmFtfWAsIHsgY2FwdHVyZTogdHJ1ZSB9KTtcbiAgfSBjYXRjaCAoZXJyKSB7XG4gICAgcmV0dXJuICcnO1xuICB9XG59XG5cbiJdfQ==
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2hlbGwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaGVscC9zaGVsbC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztBQUFBLHFEQUF1QztBQUN2Qyw2Q0FBK0I7QUFrQy9COzs7OztHQUtHO0FBQ0gsU0FBZ0IsR0FBRyxDQUFDLE9BQWUsRUFBRSxVQUFzQixFQUFFOztJQUMzRCxNQUFNLE9BQU8sR0FBRyxLQUFLLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0lBQ3JDLE1BQU0sYUFBYSxHQUFHLENBQUMsTUFBQSxPQUFPLENBQUMsT0FBTyxtQ0FBSSxLQUFLLENBQUMsQ0FBQyxDQUFDLENBQUMsTUFBTSxDQUFBLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDckUsTUFBTSxHQUFHLEdBQUcsRUFBRSxHQUFHLE9BQU8sQ0FBQyxHQUFHLEVBQUUsR0FBRyxPQUFPLENBQUMsTUFBTSxFQUFFLENBQUM7SUFDbEQsTUFBTSxNQUFNLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDLEVBQUUsT0FBTyxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsRUFBRTtRQUMzRCxLQUFLLEVBQUUsQ0FBQyxRQUFRLEVBQUUsYUFBYSxFQUFFLGFBQWEsQ0FBQztRQUMvQyxHQUFHLEVBQUUsT0FBTyxDQUFDLEdBQUc7UUFDaEIsS0FBSyxFQUFFLE9BQU8sQ0FBQyxLQUFLO1FBQ3BCLEdBQUc7S0FDSixDQUFDLENBQUM7SUFDSCxJQUFJLE1BQU0sQ0FBQyxLQUFLLEVBQUU7UUFDaEIsTUFBTSxNQUFNLENBQUMsS0FBSyxDQUFDO0tBQ3BCO0lBRUQsTUFBTSxNQUFNLEdBQUcsTUFBQSxNQUFNLENBQUMsTUFBTSwwQ0FBRSxRQUFRLEVBQUUsQ0FBQztJQUN6QyxNQUFNLE1BQU0sR0FBRyxNQUFBLE1BQU0sQ0FBQyxNQUFNLDBDQUFFLFFBQVEsRUFBRSxDQUFDO0lBRXpDLElBQUksTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDLEVBQUU7UUFDdkIsTUFBTSxPQUFPLEdBQUc7c0JBQ0UsT0FBTztnQkFDYixNQUFNO2VBQ1AsTUFBTSxFQUFFLENBQUM7UUFDcEIsTUFBTSxJQUFJLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztLQUMxQjtJQUNELE9BQU8sTUFBTSxDQUFDO0FBQ2hCLENBQUM7QUF6QkQsa0JBeUJDO0FBRUQ7Ozs7O0dBS0c7QUFDSCxTQUFnQixLQUFLLENBQUMsT0FBZTtJQUNuQyxJQUFJO1FBQ0YsT0FBTyxHQUFHLENBQUMsU0FBUyxPQUFPLEVBQUUsRUFBRSxFQUFFLE9BQU8sRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDO0tBQ25EO0lBQUMsT0FBTyxHQUFHLEVBQUU7UUFDWixPQUFPLEVBQUUsQ0FBQztLQUNYO0FBQ0gsQ0FBQztBQU5ELHNCQU1DIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgY2hpbGQgZnJvbSAnY2hpbGRfcHJvY2Vzcyc7XG5pbXBvcnQgKiBhcyBzaGxleCBmcm9tICdzaGxleCc7XG5cbi8qKlxuICogT3B0aW9ucyBmb3IgdGhlIGBydW5gIGZ1bmN0aW9uLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJ1bk9wdGlvbnMge1xuXG4gIC8qKlxuICAgKiBXb2tyaW5nIGRpcmVjdG9yeS5cbiAgICpcbiAgICogQGRlZmF1bHQgcHJvY2Vzcy5jd2QoKVxuICAgKi9cbiAgcmVhZG9ubHkgY3dkPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDYXB0dXJlIHRoZSBvdXRwdXQgb2YgdGhlIGNvbW1hbmQgYW5kIHJldHVybiB0byBjYWxsZXIuXG4gICAqXG4gICAqIEBkZWZhdWx0IC0gbm8gY2FwdHVyZSwgb3V0cHV0IGlzIHByaW50ZWQgdG8gc3Rkb3V0LlxuICAgKi9cbiAgcmVhZG9ubHkgY2FwdHVyZT86IGJvb2xlYW47XG5cbiAgLyoqXG4gICAqIFJ1biB0aGUgY29tbWFuZCBpbnNpZGUgYSBzaGVsbC5cbiAgICpcbiAgICogQGRlZmF1bHQgZmFsc2VcbiAgICovXG4gIHJlYWRvbmx5IHNoZWxsPzogYm9vbGVhbjtcblxuICAvKipcbiAgICogUHJvcGVydGllcyB0byBhZGQgdG8gJ2VudidcbiAgICovXG4gIHJlYWRvbmx5IG1vZEVudj86IFJlY29yZDxzdHJpbmcsIHN0cmluZz47XG59XG5cbi8qKlxuICogUnVuIGEgc2hlbGwgY29tbWFuZCBhbmQgcmV0dXJuIHRoZSBvdXRwdXQuXG4gKiBUaHJvd3MgaWYgdGhlIGNvbW1hbmQgZmFpbHMuXG4gKlxuICogQHBhcmFtIGNvbW1hbmQgY29tbWFuZCAoZS5nICdnaXQgY29tbWl0IC1tJylcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHJ1bihjb21tYW5kOiBzdHJpbmcsIG9wdGlvbnM6IFJ1bk9wdGlvbnMgPSB7fSk6IHN0cmluZyB7XG4gIGNvbnN0IHNoc3BsaXQgPSBzaGxleC5zcGxpdChjb21tYW5kKTtcbiAgY29uc3QgcGlwZU9ySW5oZXJpdCA9IChvcHRpb25zLmNhcHR1cmUgPz8gZmFsc2UpID8gJ3BpcGUnOiAnaW5oZXJpdCc7XG4gIGNvbnN0IGVudiA9IHsgLi4ucHJvY2Vzcy5lbnYsIC4uLm9wdGlvbnMubW9kRW52IH07XG4gIGNvbnN0IHJlc3VsdCA9IGNoaWxkLnNwYXduU3luYyhzaHNwbGl0WzBdLCBzaHNwbGl0LnNsaWNlKDEpLCB7XG4gICAgc3RkaW86IFsnaWdub3JlJywgcGlwZU9ySW5oZXJpdCwgcGlwZU9ySW5oZXJpdF0sXG4gICAgY3dkOiBvcHRpb25zLmN3ZCxcbiAgICBzaGVsbDogb3B0aW9ucy5zaGVsbCxcbiAgICBlbnYsXG4gIH0pO1xuICBpZiAocmVzdWx0LmVycm9yKSB7XG4gICAgdGhyb3cgcmVzdWx0LmVycm9yO1xuICB9XG5cbiAgY29uc3Qgc3Rkb3V0ID0gcmVzdWx0LnN0ZG91dD8udG9TdHJpbmcoKTtcbiAgY29uc3Qgc3RkZXJyID0gcmVzdWx0LnN0ZGVycj8udG9TdHJpbmcoKTtcblxuICBpZiAocmVzdWx0LnN0YXR1cyAhPT0gMCkge1xuICAgIGNvbnN0IG1lc3NhZ2UgPSBgXG4gICAgQ29tbWFuZCBmYWlsZWQ6ICR7Y29tbWFuZH0uXG4gICAgICBPdXRwdXQ6ICR7c3Rkb3V0fVxuICAgICAgRXJyb3I6ICR7c3RkZXJyfWA7XG4gICAgdGhyb3cgbmV3IEVycm9yKG1lc3NhZ2UpO1xuICB9XG4gIHJldHVybiBzdGRvdXQ7XG59XG5cbi8qKlxuICogUmV0dXJuIHRoZSBwYXRoIHVuZGVyIHdoaWNoIGEgcHJvZ3JhbSBpcyBhdmFpbGFibGUuXG4gKiBFbXB0eSBzdHJpbmcgaWYgdGhlIHByb2dyYW0gaXMgbm90IGluc3RhbGxlZC5cbiAqXG4gKiBAcGFyYW0gcHJvZ3JhbSBwcm9ncmFtIHRvIGNoZWNrIChlLmcgJ2dpdCcpXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiB3aGljaChwcm9ncmFtOiBzdHJpbmcpOiBzdHJpbmcge1xuICB0cnkge1xuICAgIHJldHVybiBydW4oYHdoaWNoICR7cHJvZ3JhbX1gLCB7IGNhcHR1cmU6IHRydWUgfSk7XG4gIH0gY2F0Y2ggKGVycikge1xuICAgIHJldHVybiAnJztcbiAgfVxufVxuXG4iXX0=

package/lib/help/sleep.d.ts

@@ -0,0 +1 @@
+export declare function sleep(ms: number): Promise<unknown>;

package/lib/help/sleep.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sleep = void 0;
+async function sleep(ms) {
+    return new Promise(ok => setTimeout(ok, ms));
+}
+exports.sleep = sleep;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2xlZXAuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvaGVscC9zbGVlcC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBTyxLQUFLLFVBQVUsS0FBSyxDQUFDLEVBQVU7SUFDcEMsT0FBTyxJQUFJLE9BQU8sQ0FBQyxFQUFFLENBQUMsRUFBRSxDQUFDLFVBQVUsQ0FBQyxFQUFFLEVBQUUsRUFBRSxDQUFDLENBQUMsQ0FBQztBQUMvQyxDQUFDO0FBRkQsc0JBRUMiLCJzb3VyY2VzQ29udGVudCI6WyJleHBvcnQgYXN5bmMgZnVuY3Rpb24gc2xlZXAobXM6IG51bWJlcikge1xuICByZXR1cm4gbmV3IFByb21pc2Uob2sgPT4gc2V0VGltZW91dChvaywgbXMpKTtcbn1cbiJdfQ==

package/package.json

@@ -7,6 +7,7 @@
   },
   "bin": {
     "jsii-release": "./bin/jsii-release-shim",
+    "jsii-release-ca": "./bin/jsii-release-shim",
     "jsii-release-golang": "./bin/jsii-release-shim",
     "jsii-release-maven": "./bin/jsii-release-shim",
     "jsii-release-npm": "./bin/jsii-release-shim",
@@ -14,6 +15,7 @@
     "jsii-release-pypi": "./bin/jsii-release-shim",
     "jsii-release-shim": "bin/jsii-release-shim",
     "publib": "bin/publib",
+    "publib-ca": "bin/publib-ca",
     "publib-golang": "bin/publib-golang",
     "publib-maven": "bin/publib-maven",
     "publib-npm": "bin/publib-npm",
@@ -28,6 +30,7 @@
     "default": "npx projen default",
     "eject": "npx projen eject",
     "eslint": "npx projen eslint",
+    "integ": "npx projen integ",
     "package": "npx projen package",
     "package-legacy": "npx projen package-legacy",
     "post-compile": "npx projen post-compile",
@@ -35,6 +38,7 @@
     "pre-compile": "npx projen pre-compile",
     "release": "npx projen release",
     "test": "npx projen test",
+    "test:update": "npx projen test:update",
     "test:watch": "npx projen test:watch",
     "unbump": "npx projen unbump",
     "upgrade": "npx projen upgrade",
@@ -43,15 +47,19 @@
   },
   "author": {
     "name": "Amazon Web Services",
+    "email": "aws-cdk-dev@amazon.com",
     "url": "https://aws.amazon.com",
     "organization": true
   },
   "devDependencies": {
     "@aws-sdk/client-sts": "^3.325.0",
+    "@types/glob": "^8.1.0",
     "@types/jest": "^27.5.2",
     "@types/node": "^16",
+    "@types/yargs": "^17",
     "@typescript-eslint/eslint-plugin": "^5",
     "@typescript-eslint/parser": "^5",
+    "cdklabs-projen-project-types": "^0.1.89",
     "eslint": "^8",
     "eslint-import-resolver-node": "^0.3.7",
     "eslint-import-resolver-typescript": "^2.7.1",
@@ -66,14 +74,20 @@
     "typescript": "~4.9.5"
   },
   "dependencies": {
+    "@aws-sdk/client-codeartifact": "^3.315.0",
+    "@aws-sdk/credential-providers": "^3.316.0",
+    "@aws-sdk/types": "^3.310.0",
     "@types/fs-extra": "^8.0.0",
     "fs-extra": "^8.0.0",
-    "shlex": "^2.1.2"
+    "glob": "10.0.0",
+    "p-queue": "6",
+    "shlex": "^2.1.2",
+    "yargs": "^17"
   },
   "main": "lib/index.js",
   "license": "Apache-2.0",
   "homepage": "https://github.com/cdklabs/publib",
-  "version": "0.2.674",
+  "version": "0.2.676",
   "jest": {
     "testMatch": [
       "<rootDir>/src/**/__tests__/**/*.ts?(x)",

package/package.json.bak

@@ -7,6 +7,7 @@
   },
   "bin": {
     "jsii-release": "./bin/jsii-release-shim",
+    "jsii-release-ca": "./bin/jsii-release-shim",
     "jsii-release-golang": "./bin/jsii-release-shim",
     "jsii-release-maven": "./bin/jsii-release-shim",
     "jsii-release-npm": "./bin/jsii-release-shim",
@@ -14,6 +15,7 @@
     "jsii-release-pypi": "./bin/jsii-release-shim",
     "jsii-release-shim": "bin/jsii-release-shim",
     "publib": "bin/publib",
+    "publib-ca": "bin/publib-ca",
     "publib-golang": "bin/publib-golang",
     "publib-maven": "bin/publib-maven",
     "publib-npm": "bin/publib-npm",
@@ -28,6 +30,7 @@
     "default": "npx projen default",
     "eject": "npx projen eject",
     "eslint": "npx projen eslint",
+    "integ": "npx projen integ",
     "package": "npx projen package",
     "package-legacy": "npx projen package-legacy",
     "post-compile": "npx projen post-compile",
@@ -35,6 +38,7 @@
     "pre-compile": "npx projen pre-compile",
     "release": "npx projen release",
     "test": "npx projen test",
+    "test:update": "npx projen test:update",
     "test:watch": "npx projen test:watch",
     "unbump": "npx projen unbump",
     "upgrade": "npx projen upgrade",
@@ -43,15 +47,19 @@
   },
   "author": {
     "name": "Amazon Web Services",
+    "email": "aws-cdk-dev@amazon.com",
     "url": "https://aws.amazon.com",
     "organization": true
   },
   "devDependencies": {
     "@aws-sdk/client-sts": "^3.325.0",
+    "@types/glob": "^8.1.0",
     "@types/jest": "^27.5.2",
     "@types/node": "^16",
+    "@types/yargs": "^17",
     "@typescript-eslint/eslint-plugin": "^5",
     "@typescript-eslint/parser": "^5",
+    "cdklabs-projen-project-types": "^0.1.89",
     "eslint": "^8",
     "eslint-import-resolver-node": "^0.3.7",
     "eslint-import-resolver-typescript": "^2.7.1",
@@ -66,14 +74,20 @@
     "typescript": "~4.9.5"
   },
   "dependencies": {
+    "@aws-sdk/client-codeartifact": "^3.315.0",
+    "@aws-sdk/credential-providers": "^3.316.0",
+    "@aws-sdk/types": "^3.310.0",
     "@types/fs-extra": "^8.0.0",
     "fs-extra": "^8.0.0",
-    "shlex": "^2.1.2"
+    "glob": "10.0.0",
+    "p-queue": "6",
+    "shlex": "^2.1.2",
+    "yargs": "^17"
   },
   "main": "lib/index.js",
   "license": "Apache-2.0",
   "homepage": "https://github.com/cdklabs/publib",
-  "version": "0.2.674",
+  "version": "0.2.676",
   "jest": {
     "testMatch": [
       "<rootDir>/src/**/__tests__/**/*.ts?(x)",