@codiac.io/codiac-cli 1.2.219 → 1.2.221

package/dist/commands/dep/source.js

@@ -1,83 +1,83 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const path = require("path");
-const core_1 = require("@oclif/core");
-const inquirer = require("inquirer");
-const command_base_tenantless_1 = require("../../command-base-tenantless");
-class DepSource extends command_base_tenantless_1.CommandBaseTenantless {
-    run() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                try {
-                    this.bootstrap();
-                    const { args, flags } = yield this.parse(DepSource);
-                    let projectRoot = this._projectRoot; //.getConfigRoot();
-                    let pkgName;
-                    let select = false;
-                    let names = yield this._ops.getNpmDependencies(projectRoot);
-                    if (!args.name || names.indexOf(args.name) < 0) {
-                        let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to edit:', choices: names });
-                        // Commented out because there is no empty response. (user can only cancel process or choose)
-                        // if (!result.name) {
-                        //   this._ui.userMessage("Operation cancelled: No work was done.");
-                        //   this.exit(0);
-                        // } else {
-                        pkgName = result.name;
-                        // }
-                    }
-                    else {
-                        pkgName = args.name;
-                    }
-                    let distSubPath;
-                    if (flags.distSubPath) {
-                        distSubPath = flags.distSubPath;
-                    }
-                    else {
-                        distSubPath = yield this._ui.prompt("distSubPath", "Enter the sub-path to the dist folder for the package.  (Enter for the repo root)", true, undefined);
-                    }
-                    let depFolder = path.join(projectRoot, "node_modules", pkgName);
-                    let pkg = this._ops.readNpmPackageJson(depFolder);
-                    // get the repoUrl for the dependency from its package.json
-                    this.logger.debug(JSON.stringify(pkg));
-                    if (pkg) {
-                        if (pkg.repository == undefined || pkg.repository == "" || pkg.repository.url == undefined || pkg.repository.url == "") {
-                            throw new Error(`Cannot source ${pkgName} because it has no repository url declared in its package definition.`);
-                        }
-                        else {
-                            let cloneUrl = pkg.repository.url;
-                            // NOTE: Need to parse out any npm prefix on the url:  git+http://  or xyz+http://.  
-                            let ptn = /^(?:[^:]+\+)/; // Matches a "something+" prefix to the protocol specifier
-                            cloneUrl = cloneUrl.replace(ptn, "");
-                            // Use toyhauler-auth-contracts to test
-                            let pkgVersion = pkg.version;
-                            this._ui.userMessage(`pkg: ${pkgName}, cloneUrl: ${cloneUrl}, lastUsedVersion: ${pkgVersion}`);
-                            let subm = yield this._ops.addSubmodule(cloneUrl, pkgName, pkgVersion);
-                            subm.distributionRoot = distSubPath;
-                            yield this._ops.symLinkSubmodule(subm);
-                        }
-                    }
-                    else {
-                        throw new Error(`Cannot source ${pkgName} because it has no package definition file.`);
-                    }
-                    resolve();
-                }
-                catch (err) {
-                    this.handleError(err);
-                    reject(err);
-                }
-            }));
-        });
-    }
-}
-exports.default = DepSource;
-DepSource.description = 'Loads the source code for the given dependency';
-DepSource.aliases = ['dep:src'];
-DepSource.flags = {
-    help: core_1.Flags.help({ char: 'h' }),
-    distSubPath: core_1.Flags.string({ char: 'd', description: "Subfolder path, relative to the root of the submodule,  to the folder from which the package is created,  aka: the build output folder or 'dist' folder (eg: bin, dist, or lib, ...etc).  This folder is used as the target folder for npm link." })
-};
-DepSource.args = {
-    name: core_1.Args.string({ description: 'The official unique name of the dependency package.' })
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const path = require("path");
+const core_1 = require("@oclif/core");
+const inquirer = require("inquirer");
+const command_base_tenantless_1 = require("../../command-base-tenantless");
+class DepSource extends command_base_tenantless_1.CommandBaseTenantless {
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    this.bootstrap();
+                    const { args, flags } = yield this.parse(DepSource);
+                    let projectRoot = this._projectRoot; //.getConfigRoot();
+                    let pkgName;
+                    let select = false;
+                    let names = yield this._ops.getNpmDependencies(projectRoot);
+                    if (!args.name || names.indexOf(args.name) < 0) {
+                        let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to edit:', choices: names });
+                        // Commented out because there is no empty response. (user can only cancel process or choose)
+                        // if (!result.name) {
+                        //   this._ui.userMessage("Operation cancelled: No work was done.");
+                        //   this.exit(0);
+                        // } else {
+                        pkgName = result.name;
+                        // }
+                    }
+                    else {
+                        pkgName = args.name;
+                    }
+                    let distSubPath;
+                    if (flags.distSubPath) {
+                        distSubPath = flags.distSubPath;
+                    }
+                    else {
+                        distSubPath = yield this._ui.prompt("distSubPath", "Enter the sub-path to the dist folder for the package.  (Enter for the repo root)", true, undefined);
+                    }
+                    let depFolder = path.join(projectRoot, "node_modules", pkgName);
+                    let pkg = this._ops.readNpmPackageJson(depFolder);
+                    // get the repoUrl for the dependency from its package.json
+                    this.logger.debug(JSON.stringify(pkg));
+                    if (pkg) {
+                        if (pkg.repository == undefined || pkg.repository == "" || pkg.repository.url == undefined || pkg.repository.url == "") {
+                            throw new Error(`Cannot source ${pkgName} because it has no repository url declared in its package definition.`);
+                        }
+                        else {
+                            let cloneUrl = pkg.repository.url;
+                            // NOTE: Need to parse out any npm prefix on the url:  git+http://  or xyz+http://.  
+                            let ptn = /^(?:[^:]+\+)/; // Matches a "something+" prefix to the protocol specifier
+                            cloneUrl = cloneUrl.replace(ptn, "");
+                            // Use toyhauler-auth-contracts to test
+                            let pkgVersion = pkg.version;
+                            this._ui.userMessage(`pkg: ${pkgName}, cloneUrl: ${cloneUrl}, lastUsedVersion: ${pkgVersion}`);
+                            let subm = yield this._ops.addSubmodule(cloneUrl, pkgName, pkgVersion);
+                            subm.distributionRoot = distSubPath;
+                            yield this._ops.symLinkSubmodule(subm);
+                        }
+                    }
+                    else {
+                        throw new Error(`Cannot source ${pkgName} because it has no package definition file.`);
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    this.handleError(err);
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.default = DepSource;
+DepSource.description = 'Loads the source code for the given dependency';
+DepSource.aliases = ['dep:src'];
+DepSource.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+    distSubPath: core_1.Flags.string({ char: 'd', description: "Subfolder path, relative to the root of the submodule,  to the folder from which the package is created,  aka: the build output folder or 'dist' folder (eg: bin, dist, or lib, ...etc).  This folder is used as the target folder for npm link." })
+};
+DepSource.args = {
+    name: core_1.Args.string({ description: 'The official unique name of the dependency package.' })
+};
 //# sourceMappingURL=source.js.map

package/dist/commands/dep/syncup.d.ts

@@ -1,11 +1,11 @@
-import { CommandBaseTenantless } from '../../command-base-tenantless';
-export default class DepSyncup extends CommandBaseTenantless {
-    static description: string;
-    static flags: {
-        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
-    };
-    static args: {
-        dependency: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
-    };
-    run(): Promise<void>;
-}
+import { CommandBaseTenantless } from '../../command-base-tenantless';
+export default class DepSyncup extends CommandBaseTenantless {
+    static description: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+    };
+    static args: {
+        dependency: import("@oclif/core/lib/interfaces/parser").Arg<string, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dep/syncup.js

@@ -1,54 +1,54 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const core_1 = require("@oclif/core");
-const inquirer = require("inquirer");
-const command_base_tenantless_1 = require("../../command-base-tenantless");
-class DepSyncup extends command_base_tenantless_1.CommandBaseTenantless {
-    run() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                try {
-                    this.bootstrap();
-                    const { args, flags } = yield this.parse(DepSyncup);
-                    let projectRoot = this._ops.getConfigRoot();
-                    let dep = args.dependency;
-                    // Support version suffixes (eg: my-fav-pkg@3.14.5)
-                    let depNames = yield this._projCfg.submodules.map(sm => sm.folderName);
-                    if (depNames.length > 0) {
-                        if (!dep || depNames.indexOf(dep) < 0) {
-                            let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to sync up into main project:', choices: depNames });
-                            if (!result.name) {
-                                this._ui.userMessage("Operation cancelled: No work was done.");
-                                this.exit(0);
-                            }
-                            else {
-                                dep = result.name;
-                            }
-                        }
-                        // this.logger.notice(`This feature is pending and is not yet available, so ${this._styler.hilite(dep)} will have to be built, checked in, published, and consumed manually.  No work wwas done.`);
-                        this._ui.userMessage(`This feature is pending and is not yet available, so ${this._styler.hilite(dep)} will have to be built, checked in, published, and consumed manually.  No work wwas done.`);
-                    }
-                    else {
-                        this.logger.error(`No dependencies to sync because none are currently sourced.`, `Use 'cod dep:source' to source dependency.  No work was done.`);
-                        this._ui.userMessage(`No dependencies to sync because none are currently sourced.`);
-                    }
-                    resolve();
-                }
-                catch (err) {
-                    this.handleError(err);
-                    reject(err);
-                }
-            }));
-        });
-    }
-}
-exports.default = DepSyncup;
-DepSyncup.description = 'Publishes the dependency in its current state and upgrades to it in the main project.';
-DepSyncup.flags = {
-    help: core_1.Flags.help({ char: 'h' }),
-};
-DepSyncup.args = {
-    dependency: core_1.Args.string({ description: 'The package name of the dependency to sync up into the main project', required: true })
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const inquirer = require("inquirer");
+const command_base_tenantless_1 = require("../../command-base-tenantless");
+class DepSyncup extends command_base_tenantless_1.CommandBaseTenantless {
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    this.bootstrap();
+                    const { args, flags } = yield this.parse(DepSyncup);
+                    let projectRoot = this._ops.getConfigRoot();
+                    let dep = args.dependency;
+                    // Support version suffixes (eg: my-fav-pkg@3.14.5)
+                    let depNames = yield this._projCfg.submodules.map(sm => sm.folderName);
+                    if (depNames.length > 0) {
+                        if (!dep || depNames.indexOf(dep) < 0) {
+                            let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to sync up into main project:', choices: depNames });
+                            if (!result.name) {
+                                this._ui.userMessage("Operation cancelled: No work was done.");
+                                this.exit(0);
+                            }
+                            else {
+                                dep = result.name;
+                            }
+                        }
+                        // this.logger.notice(`This feature is pending and is not yet available, so ${this._styler.hilite(dep)} will have to be built, checked in, published, and consumed manually.  No work wwas done.`);
+                        this._ui.userMessage(`This feature is pending and is not yet available, so ${this._styler.hilite(dep)} will have to be built, checked in, published, and consumed manually.  No work wwas done.`);
+                    }
+                    else {
+                        this.logger.error(`No dependencies to sync because none are currently sourced.`, `Use 'cod dep:source' to source dependency.  No work was done.`);
+                        this._ui.userMessage(`No dependencies to sync because none are currently sourced.`);
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    this.handleError(err);
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.default = DepSyncup;
+DepSyncup.description = 'Publishes the dependency in its current state and upgrades to it in the main project.';
+DepSyncup.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+};
+DepSyncup.args = {
+    dependency: core_1.Args.string({ description: 'The package name of the dependency to sync up into the main project', required: true })
+};
 //# sourceMappingURL=syncup.js.map

package/dist/commands/dep/unsource.d.ts

@@ -1,14 +1,14 @@
-import { CommandBaseTenantless } from '../../command-base-tenantless';
-export default class DepUnsource extends CommandBaseTenantless {
-    static description: string;
-    static aliases: string[];
-    static flags: {
-        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
-        discard: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        comment: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-    };
-    static args: {
-        name: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
-    };
-    run(): Promise<void>;
-}
+import { CommandBaseTenantless } from '../../command-base-tenantless';
+export default class DepUnsource extends CommandBaseTenantless {
+    static description: string;
+    static aliases: string[];
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        discard: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        comment: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+    };
+    static args: {
+        name: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+}

package/dist/commands/dep/unsource.js

@@ -1,68 +1,68 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-const core_1 = require("@oclif/core");
-const inquirer = require("inquirer");
-const command_base_tenantless_1 = require("../../command-base-tenantless");
-class DepUnsource extends command_base_tenantless_1.CommandBaseTenantless {
-    run() {
-        return tslib_1.__awaiter(this, void 0, void 0, function* () {
-            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
-                try {
-                    this.bootstrap();
-                    const { args, flags } = yield this.parse(DepUnsource);
-                    let projectRoot = this._ops.getConfigRoot();
-                    let select = false;
-                    let names = yield this._projCfg.submodules.map(sm => sm.folderName);
-                    if (names.length == 0) {
-                        this.logger.error(`Cannot unsource: none of your dependencies are currently sourced.`, `Use 'cod dep:source' to source a dependency.`);
-                    }
-                    else {
-                        let name;
-                        if (args.name && names.indexOf(args.name) >= 0) {
-                            name = args.name;
-                        }
-                        else {
-                            let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to unsource:', choices: names });
-                            if (!result.name) {
-                                this._ui.userMessage("Operation cancelled: No work was done.");
-                                this.exit(0);
-                            }
-                            else {
-                                name = result.name;
-                            }
-                        }
-                        if (name !== undefined) {
-                            yield this._ops.unSymLinkSubmodule(name);
-                            yield this._ops.removeSubmodule(name, flags.discard);
-                        }
-                        // let nxVersion = "";
-                        // if (flags.discard) {
-                        //   nxVersion = "last used version"  // where do we get this?
-                        // } else {
-                        //   nxVersion = "version just published"  // we'll need removeSubmodule to return this
-                        // }
-                        // await this._ops.dependencyInstall(name, nxVersion);
-                    }
-                    resolve();
-                }
-                catch (err) {
-                    this.handleError(err);
-                    reject(err);
-                }
-            }));
-        });
-    }
-}
-exports.default = DepUnsource;
-DepUnsource.description = 'Exits source mode for the given dependency by physically removing its source code folder from the project, and points the project dependency back to the package version it previously depended on.';
-DepUnsource.aliases = ['dep:unsrc'];
-DepUnsource.flags = {
-    help: core_1.Flags.help({ char: 'h' }),
-    discard: core_1.Flags.boolean({ char: 'd', description: 'Discards all uncommitted changes (staged and unstaged) before unsourcing, and goes back to the previously installed version of the dependency.  Again, uncomitted changes are LOST when this flag is set.' }),
-    comment: core_1.Flags.boolean({ char: 'c', description: 'The commit message for any outstanding changes.' })
-};
-DepUnsource.args = {
-    name: core_1.Args.string({ required: false, description: 'The official unique name of the dependency package.' })
-};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+const core_1 = require("@oclif/core");
+const inquirer = require("inquirer");
+const command_base_tenantless_1 = require("../../command-base-tenantless");
+class DepUnsource extends command_base_tenantless_1.CommandBaseTenantless {
+    run() {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            return new Promise((resolve, reject) => tslib_1.__awaiter(this, void 0, void 0, function* () {
+                try {
+                    this.bootstrap();
+                    const { args, flags } = yield this.parse(DepUnsource);
+                    let projectRoot = this._ops.getConfigRoot();
+                    let select = false;
+                    let names = yield this._projCfg.submodules.map(sm => sm.folderName);
+                    if (names.length == 0) {
+                        this.logger.error(`Cannot unsource: none of your dependencies are currently sourced.`, `Use 'cod dep:source' to source a dependency.`);
+                    }
+                    else {
+                        let name;
+                        if (args.name && names.indexOf(args.name) >= 0) {
+                            name = args.name;
+                        }
+                        else {
+                            let result = yield inquirer.prompt({ type: 'list', name: 'name', message: 'dependency to unsource:', choices: names });
+                            if (!result.name) {
+                                this._ui.userMessage("Operation cancelled: No work was done.");
+                                this.exit(0);
+                            }
+                            else {
+                                name = result.name;
+                            }
+                        }
+                        if (name !== undefined) {
+                            yield this._ops.unSymLinkSubmodule(name);
+                            yield this._ops.removeSubmodule(name, flags.discard);
+                        }
+                        // let nxVersion = "";
+                        // if (flags.discard) {
+                        //   nxVersion = "last used version"  // where do we get this?
+                        // } else {
+                        //   nxVersion = "version just published"  // we'll need removeSubmodule to return this
+                        // }
+                        // await this._ops.dependencyInstall(name, nxVersion);
+                    }
+                    resolve();
+                }
+                catch (err) {
+                    this.handleError(err);
+                    reject(err);
+                }
+            }));
+        });
+    }
+}
+exports.default = DepUnsource;
+DepUnsource.description = 'Exits source mode for the given dependency by physically removing its source code folder from the project, and points the project dependency back to the package version it previously depended on.';
+DepUnsource.aliases = ['dep:unsrc'];
+DepUnsource.flags = {
+    help: core_1.Flags.help({ char: 'h' }),
+    discard: core_1.Flags.boolean({ char: 'd', description: 'Discards all uncommitted changes (staged and unstaged) before unsourcing, and goes back to the previously installed version of the dependency.  Again, uncomitted changes are LOST when this flag is set.' }),
+    comment: core_1.Flags.boolean({ char: 'c', description: 'The commit message for any outstanding changes.' })
+};
+DepUnsource.args = {
+    name: core_1.Args.string({ required: false, description: 'The official unique name of the dependency package.' })
+};
 //# sourceMappingURL=unsource.js.map

package/dist/commands/dep/upgrade.d.ts

@@ -1,44 +1,44 @@
-import { CommandBaseTenantless } from '../../command-base-tenantless';
-export default class DepUpgrade extends CommandBaseTenantless {
-    static description: string;
-    static flags: {
-        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
-        version: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
-    };
-    static args: {
-        dependency: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
-    };
-    run(): Promise<void>;
-    promptForVersion(packageName: string, defaultVersion?: string, versionSearch?: string): Promise<string>;
-    private fetchVersions;
-    private searchVersions;
-    /** Retrieves the list of dependencies that are out of date with the registry.
-     * Provides for each package: the version currently installed,
-     * the latest version that complies with the symantic range,
-     * and the latest version overall.
-     */
-    private getNpmUpgrades;
-}
-export type UpgradeState = {
-    [name: string]: SingleUpgradeState;
-};
-/** A snapshot of the current version versus what's available in the registry.
- * @see https://docs.npmjs.com/cli-commands/outdated.html
-*/
-export type SingleUpgradeState = {
-    /** The currently version **actually installed**, not the SemVer entry in the package.json. */
-    current: string;
-    /** wanted is the maximum version of the package that satisfies the semver range specified in package.json.
-     * If there’s no available semver range, then wanted shows the currently-installed version. */
-    wanted: string;
-    /**  latest is the version of the package tagged as latest in the registry.
-     * Running npm publish with no special configuration will publish the package with a dist-tag of latest.
-     * This may or may not be the maximum version of the package,
-     * or the most-recently published version of the package,
-     * depending on how the package’s developer manages the latest dist-tag. */
-    latest: string;
-    /** location is where in the dependency tree the package is located.
-     * Note that npm outdated defaults to a depth of 0, so unless you override that,
-     * you’ll always be seeing only top-level dependencies that are outdated. */
-    location: string;
-};
+import { CommandBaseTenantless } from '../../command-base-tenantless';
+export default class DepUpgrade extends CommandBaseTenantless {
+    static description: string;
+    static flags: {
+        help: import("@oclif/core/lib/interfaces").BooleanFlag<void>;
+        version: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser").CustomOptions>;
+    };
+    static args: {
+        dependency: import("@oclif/core/lib/interfaces/parser").Arg<string | undefined, Record<string, unknown>>;
+    };
+    run(): Promise<void>;
+    promptForVersion(packageName: string, defaultVersion?: string, versionSearch?: string): Promise<string>;
+    private fetchVersions;
+    private searchVersions;
+    /** Retrieves the list of dependencies that are out of date with the registry.
+     * Provides for each package: the version currently installed,
+     * the latest version that complies with the symantic range,
+     * and the latest version overall.
+     */
+    private getNpmUpgrades;
+}
+export type UpgradeState = {
+    [name: string]: SingleUpgradeState;
+};
+/** A snapshot of the current version versus what's available in the registry.
+ * @see https://docs.npmjs.com/cli-commands/outdated.html
+*/
+export type SingleUpgradeState = {
+    /** The currently version **actually installed**, not the SemVer entry in the package.json. */
+    current: string;
+    /** wanted is the maximum version of the package that satisfies the semver range specified in package.json.
+     * If there’s no available semver range, then wanted shows the currently-installed version. */
+    wanted: string;
+    /**  latest is the version of the package tagged as latest in the registry.
+     * Running npm publish with no special configuration will publish the package with a dist-tag of latest.
+     * This may or may not be the maximum version of the package,
+     * or the most-recently published version of the package,
+     * depending on how the package’s developer manages the latest dist-tag. */
+    latest: string;
+    /** location is where in the dependency tree the package is located.
+     * Note that npm outdated defaults to a depth of 0, so unless you override that,
+     * you’ll always be seeing only top-level dependencies that are outdated. */
+    location: string;
+};