@jsdevtools/npm-publish 1.4.3 → 2.1.0

package/lib/cli/index.js

@@ -1,64 +1,71 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.main = void 0;
-const path_1 = require("path");
-const npm_publish_1 = require("../npm-publish");
-const read_manifest_1 = require("../read-manifest");
-const exit_code_1 = require("./exit-code");
-const help_1 = require("./help");
-const parse_args_1 = require("./parse-args");
+exports.main = exports.USAGE = void 0;
+const index_js_1 = require("../index.js");
+const parse_cli_arguments_js_1 = require("./parse-cli-arguments.js");
+exports.USAGE = `
+Usage:
+
+  npm-publish <options> [package]
+
+Arguments:
+
+  package                 The path to the package to publish.
+                          May be a directory, package.json, or .tgz file.
+                          Defaults to the package in the current directory.
+
+Options:
+
+  --token <token>         (Required) npm authentication token.
+
+  --registry <url>        Registry to read from and write to.
+                          Defaults to "https://registry.npmjs.org/".
+
+  --tag <tag>             The distribution tag to check against and publish to.
+                          Defaults to "latest".
+
+  --access <access>       Package access, may be "public" or "restricted".
+                          See npm documentation for details.
+
+  --provenance            Publish with provenance statements.
+                          See npm documentation for details.
+
+  --strategy <strategy>   Publish strategy, may be "all" or "upgrade".
+                          Defaults to "all", see documentation for details.
+
+  --dry-run               Do not actually publish anything.
+  --quiet                 Only print errors.
+  --debug                 Print debug logs.
+
+  -v, --version           Print the version number.
+  -h, --help              Show usage text.
+
+Examples:
+
+  $ npm-publish --token abc123 ./my-package
+`;
 /**
  * The main entry point of the CLI
  *
- * @param args - The command-line arguments
+ * @param argv - The list of argument strings passed to the program.
+ * @param version - The version of this program.
  */
-async function main(args) {
-    try {
-        // Setup global error handlers
-        process.on("uncaughtException", errorHandler);
-        process.on("unhandledRejection", errorHandler);
-        // Parse the command-line arguments
-        let { help, version, options } = parse_args_1.parseArgs(args);
-        if (help) {
-            // Show the help text and exit
-            console.log(help_1.usageText);
-            process.exit(exit_code_1.ExitCode.Success);
-        }
-        else if (version) {
-            // Show the version number and exit
-            let manifest = await read_manifest_1.readManifest(path_1.join(__dirname, "../../package.json"));
-            console.log(manifest.version.toString());
-            process.exit(exit_code_1.ExitCode.Success);
-        }
-        else {
-            let results = await npm_publish_1.npmPublish(options);
-            if (!options.quiet) {
-                if (results.type === "none") {
-                    console.log(`\n📦 ${results.package} v${results.version} is already published to NPM`);
-                }
-                else if (results.dryRun) {
-                    console.log(`\n📦 ${results.package} v${results.version} was NOT actually published to NPM (dry run)`);
-                }
-                else {
-                    console.log(`\n📦 Successfully published ${results.package} v${results.version} to NPM`);
-                }
-            }
-        }
+async function main(argv, version) {
+    const cliArguments = (0, parse_cli_arguments_js_1.parseCliArguments)(argv);
+    if (cliArguments.help) {
+        console.info(exports.USAGE);
+        return;
     }
-    catch (error) {
-        errorHandler(error);
+    if (cliArguments.version) {
+        console.info(version);
+        return;
     }
+    const logger = {
+        error: console.error,
+        info: cliArguments.quiet === false ? console.info : undefined,
+        debug: cliArguments.debug === true ? console.debug : undefined,
+    };
+    await (0, index_js_1.npmPublish)({ ...cliArguments.options, logger });
 }
 exports.main = main;
-/**
- * Prints errors to the console
- */
-function errorHandler(error) {
-    let message = error.message || String(error);
-    if (process.env.DEBUG || process.env.NODE_ENV === "development") {
-        message = error.stack || message;
-    }
-    console.error(message);
-    process.exit(exit_code_1.ExitCode.FatalError);
-}
 //# sourceMappingURL=index.js.map

package/lib/cli/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAAA,+BAA4B;AAC5B,gDAA4C;AAC5C,oDAAgD;AAChD,2CAAuC;AACvC,iCAAmC;AACnC,6CAAyC;AAEzC;;;;GAIG;AACI,KAAK,UAAU,IAAI,CAAC,IAAc;IACvC,IAAI;QACF,8BAA8B;QAC9B,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,YAAY,CAAC,CAAC;QAC9C,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,YAAY,CAAC,CAAC;QAE/C,mCAAmC;QACnC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,sBAAS,CAAC,IAAI,CAAC,CAAC;QAEjD,IAAI,IAAI,EAAE;YACR,8BAA8B;YAC9B,OAAO,CAAC,GAAG,CAAC,gBAAS,CAAC,CAAC;YACvB,OAAO,CAAC,IAAI,CAAC,oBAAQ,CAAC,OAAO,CAAC,CAAC;SAChC;aACI,IAAI,OAAO,EAAE;YAChB,mCAAmC;YACnC,IAAI,QAAQ,GAAG,MAAM,4BAAY,CAAC,WAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,oBAAQ,CAAC,OAAO,CAAC,CAAC;SAChC;aACI;YACH,IAAI,OAAO,GAAG,MAAM,wBAAU,CAAC,OAAO,CAAC,CAAC;YAExC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE;gBAClB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE;oBAC3B,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,8BAA8B,CAAC,CAAC;iBACxF;qBACI,IAAI,OAAO,CAAC,MAAM,EAAE;oBACvB,OAAO,CAAC,GAAG,CAAC,QAAQ,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,8CAA8C,CAAC,CAAC;iBACxG;qBACI;oBACH,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,CAAC,OAAO,KAAK,OAAO,CAAC,OAAO,SAAS,CAAC,CAAC;iBAC1F;aACF;SACF;KACF;IACD,OAAO,KAAK,EAAE;QACZ,YAAY,CAAC,KAAc,CAAC,CAAC;KAC9B;AACH,CAAC;AAvCD,oBAuCC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,KAAY;IAChC,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,aAAa,EAAE;QAC/D,OAAO,GAAG,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC;KAClC;IAED,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACvB,OAAO,CAAC,IAAI,CAAC,oBAAQ,CAAC,UAAU,CAAC,CAAC;AACpC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AAAA,0CAAsD;AACtD,qEAA6D;AAEhD,QAAA,KAAK,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCpB,CAAC;AAEF;;;;;GAKG;AACI,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,OAAe;IACxD,MAAM,YAAY,GAAG,IAAA,0CAAiB,EAAC,IAAI,CAAC,CAAC;IAE7C,IAAI,YAAY,CAAC,IAAI,EAAE;QACrB,OAAO,CAAC,IAAI,CAAC,aAAK,CAAC,CAAC;QACpB,OAAO;KACR;IAED,IAAI,YAAY,CAAC,OAAO,EAAE;QACxB,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACtB,OAAO;KACR;IAED,MAAM,MAAM,GAAW;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,IAAI,EAAE,YAAY,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC7D,KAAK,EAAE,YAAY,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;KAC/D,CAAC;IAEF,MAAM,IAAA,qBAAU,EAAC,EAAE,GAAG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;AACxD,CAAC;AApBD,oBAoBC"}

package/lib/cli/parse-cli-arguments.d.ts

@@ -0,0 +1,17 @@
+/** Wrapper module for command-line-args */
+import type { Options } from "../options.js";
+/** The parsed command-line arguments */
+export interface ParsedArguments {
+    help?: boolean;
+    version?: boolean;
+    quiet?: boolean;
+    debug?: boolean;
+    options: Options;
+}
+/**
+ * Parse the given command-line arguments.
+ *
+ * @param argv The list of argument strings passed to the program.
+ * @returns A parsed object of options.
+ */
+export declare function parseCliArguments(argv: string[]): ParsedArguments;

package/lib/cli/parse-cli-arguments.js

@@ -0,0 +1,40 @@
+"use strict";
+/** Wrapper module for command-line-args */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCliArguments = void 0;
+const command_line_args_1 = __importDefault(require("command-line-args"));
+const ARGUMENTS_OPTIONS = [
+    { name: "package", type: String, defaultOption: true },
+    { name: "token", type: String },
+    { name: "registry", type: String },
+    { name: "tag", type: String },
+    { name: "access", type: String },
+    { name: "provenance", type: Boolean },
+    { name: "strategy", type: String },
+    { name: "dry-run", type: Boolean },
+    { name: "quiet", type: Boolean },
+    { name: "debug", type: Boolean },
+    { name: "version", alias: "v", type: Boolean },
+    { name: "help", alias: "h", type: Boolean },
+];
+/**
+ * Parse the given command-line arguments.
+ *
+ * @param argv The list of argument strings passed to the program.
+ * @returns A parsed object of options.
+ */
+function parseCliArguments(argv) {
+    const { help, version, quiet, debug, ...options } = (0, command_line_args_1.default)(ARGUMENTS_OPTIONS, { argv, camelCase: true });
+    return {
+        help: Boolean(help),
+        version: Boolean(version),
+        quiet: Boolean(quiet),
+        debug: Boolean(debug),
+        options: options,
+    };
+}
+exports.parseCliArguments = parseCliArguments;
+//# sourceMappingURL=parse-cli-arguments.js.map

package/lib/cli/parse-cli-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-cli-arguments.js","sourceRoot":"","sources":["../../src/cli/parse-cli-arguments.ts"],"names":[],"mappings":";AAAA,2CAA2C;;;;;;AAE3C,0EAAgD;AAGhD,MAAM,iBAAiB,GAAG;IACxB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE;IACtD,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE;IAC/B,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;IAClC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE;IAC7B,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE;IAChC,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE;IACrC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE;IAClC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE;IAClC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAChC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE;IAChC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;IAC9C,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE;CAC5C,CAAC;AAWF;;;;;GAKG;AACH,SAAgB,iBAAiB,CAAC,IAAc;IAC9C,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,GAAG,IAAA,2BAAe,EACjE,iBAAiB,EACjB,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAC1B,CAAC;IAEF,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;QACnB,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC;QACzB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;QACrB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;QACrB,OAAO,EAAE,OAAkB;KAC5B,CAAC;AACJ,CAAC;AAbD,8CAaC"}

package/lib/compare-and-publish/compare-and-publish.d.ts

@@ -0,0 +1,21 @@
+import type { PackageManifest } from "../read-manifest.js";
+import type { NormalizedOptions } from "../normalize-options.js";
+import { type NpmCliEnvironment } from "../npm/index.js";
+import { type VersionComparison } from "./compare-versions.js";
+export interface PublishResult extends VersionComparison {
+    id: string | undefined;
+    files: PublishFile[];
+}
+export interface PublishFile {
+    path: string;
+    size: number;
+}
+/**
+ * Get the currently published versions of a package and publish if needed.
+ *
+ * @param manifest The package to potentially publish.
+ * @param options Configuration options.
+ * @param environment Environment variables for the npm cli.
+ * @returns Information about the publish, including if it occurred.
+ */
+export declare function compareAndPublish(manifest: PackageManifest, options: NormalizedOptions, environment: NpmCliEnvironment): Promise<PublishResult>;

package/lib/compare-and-publish/compare-and-publish.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareAndPublish = void 0;
+const index_js_1 = require("../npm/index.js");
+const compare_versions_js_1 = require("./compare-versions.js");
+const get_arguments_js_1 = require("./get-arguments.js");
+/**
+ * Get the currently published versions of a package and publish if needed.
+ *
+ * @param manifest The package to potentially publish.
+ * @param options Configuration options.
+ * @param environment Environment variables for the npm cli.
+ * @returns Information about the publish, including if it occurred.
+ */
+async function compareAndPublish(manifest, options, environment) {
+    const { name, version, packageSpec } = manifest;
+    const cliOptions = { environment, logger: options.logger };
+    const viewArguments = (0, get_arguments_js_1.getViewArguments)(name, options);
+    const publishArguments = (0, get_arguments_js_1.getPublishArguments)(packageSpec, options);
+    let viewCall = await (0, index_js_1.callNpmCli)(index_js_1.VIEW, viewArguments, cliOptions);
+    // `npm view` will succeed with no output the package exists in the registry
+    // with no `latest` tag. This is only possible with third-party registries.
+    // https://github.com/npm/cli/issues/6408
+    if (!viewCall.successData && !viewCall.error) {
+        // Retry the call to `npm view` with the configured publish tag,
+        // to at least try to get something.
+        const viewWithTagArguments = (0, get_arguments_js_1.getViewArguments)(name, options, true);
+        viewCall = await (0, index_js_1.callNpmCli)(index_js_1.VIEW, viewWithTagArguments, cliOptions);
+    }
+    if (viewCall.error && viewCall.errorCode !== index_js_1.E404) {
+        throw viewCall.error;
+    }
+    const comparison = (0, compare_versions_js_1.compareVersions)(version, viewCall.successData, options);
+    const publishCall = comparison.type
+        ? await (0, index_js_1.callNpmCli)(index_js_1.PUBLISH, publishArguments, cliOptions)
+        : { successData: undefined, errorCode: undefined, error: undefined };
+    if (publishCall.error && publishCall.errorCode !== index_js_1.EPUBLISHCONFLICT) {
+        throw publishCall.error;
+    }
+    const { successData: publishData } = publishCall;
+    return {
+        id: publishData?.id,
+        files: publishData?.files ?? [],
+        type: publishData ? comparison.type : undefined,
+        oldVersion: comparison.oldVersion,
+    };
+}
+exports.compareAndPublish = compareAndPublish;
+//# sourceMappingURL=compare-and-publish.js.map

package/lib/compare-and-publish/compare-and-publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-and-publish.js","sourceRoot":"","sources":["../../src/compare-and-publish/compare-and-publish.ts"],"names":[],"mappings":";;;AAEA,8CAOyB;AACzB,+DAAgF;AAChF,yDAA2E;AAY3E;;;;;;;GAOG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAAyB,EACzB,OAA0B,EAC1B,WAA8B;IAE9B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,QAAQ,CAAC;IAChD,MAAM,UAAU,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC;IAE3D,MAAM,aAAa,GAAG,IAAA,mCAAgB,EAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtD,MAAM,gBAAgB,GAAG,IAAA,sCAAmB,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACnE,IAAI,QAAQ,GAAG,MAAM,IAAA,qBAAU,EAAC,eAAI,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAEjE,4EAA4E;IAC5E,2EAA2E;IAC3E,yCAAyC;IACzC,IAAI,CAAC,QAAQ,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE;QAC5C,gEAAgE;QAChE,oCAAoC;QACpC,MAAM,oBAAoB,GAAG,IAAA,mCAAgB,EAAC,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;QACnE,QAAQ,GAAG,MAAM,IAAA,qBAAU,EAAC,eAAI,EAAE,oBAAoB,EAAE,UAAU,CAAC,CAAC;KACrE;IAED,IAAI,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC,SAAS,KAAK,eAAI,EAAE;QACjD,MAAM,QAAQ,CAAC,KAAK,CAAC;KACtB;IAED,MAAM,UAAU,GAAG,IAAA,qCAAe,EAAC,OAAO,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAC3E,MAAM,WAAW,GAAG,UAAU,CAAC,IAAI;QACjC,CAAC,CAAC,MAAM,IAAA,qBAAU,EAAC,kBAAO,EAAE,gBAAgB,EAAE,UAAU,CAAC;QACzD,CAAC,CAAC,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAEvE,IAAI,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,SAAS,KAAK,2BAAgB,EAAE;QACnE,MAAM,WAAW,CAAC,KAAK,CAAC;KACzB;IAED,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,GAAG,WAAW,CAAC;IAEjD,OAAO;QACL,EAAE,EAAE,WAAW,EAAE,EAAE;QACnB,KAAK,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE;QAC/B,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QAC/C,UAAU,EAAE,UAAU,CAAC,UAAU;KAClC,CAAC;AACJ,CAAC;AA3CD,8CA2CC"}

package/lib/compare-and-publish/compare-versions.d.ts

@@ -0,0 +1,16 @@
+import type { NormalizedOptions } from "../normalize-options.js";
+import type { ReleaseType } from "../results.js";
+import type { NpmViewData } from "../npm/index.js";
+export interface VersionComparison {
+    type: ReleaseType | undefined;
+    oldVersion: string | undefined;
+}
+/**
+ * Compare previously published versions with the package's current version.
+ *
+ * @param currentVersion The current package version.
+ * @param publishedVersions The versions that have already been published.
+ * @param options Configuration options
+ * @returns The release type and previous version.
+ */
+export declare function compareVersions(currentVersion: string, publishedVersions: NpmViewData | undefined, options: NormalizedOptions): VersionComparison;

package/lib/compare-and-publish/compare-versions.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareVersions = void 0;
+const diff_js_1 = __importDefault(require("semver/functions/diff.js"));
+const gt_js_1 = __importDefault(require("semver/functions/gt.js"));
+const valid_js_1 = __importDefault(require("semver/functions/valid.js"));
+const options_js_1 = require("../options.js");
+const INITIAL = "initial";
+const DIFFERENT = "different";
+/**
+ * Compare previously published versions with the package's current version.
+ *
+ * @param currentVersion The current package version.
+ * @param publishedVersions The versions that have already been published.
+ * @param options Configuration options
+ * @returns The release type and previous version.
+ */
+function compareVersions(currentVersion, publishedVersions, options) {
+    const { versions, "dist-tags": tags } = publishedVersions ?? {};
+    const { strategy, tag: publishTag } = options;
+    const oldVersion = (0, valid_js_1.default)(tags?.[publishTag.value]) ?? undefined;
+    const isUnique = !versions?.includes(currentVersion);
+    let type;
+    if (isUnique) {
+        if (!oldVersion) {
+            type = INITIAL;
+        }
+        else if ((0, gt_js_1.default)(currentVersion, oldVersion)) {
+            type = (0, diff_js_1.default)(currentVersion, oldVersion) ?? DIFFERENT;
+        }
+        else if (strategy.value === options_js_1.STRATEGY_ALL) {
+            type = DIFFERENT;
+        }
+    }
+    return { type, oldVersion };
+}
+exports.compareVersions = compareVersions;
+//# sourceMappingURL=compare-versions.js.map

package/lib/compare-and-publish/compare-versions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-versions.js","sourceRoot":"","sources":["../../src/compare-and-publish/compare-versions.ts"],"names":[],"mappings":";;;;;;AAAA,uEAAwD;AACxD,mEAAuD;AACvD,yEAAoD;AAEpD,8CAA6C;AAU7C,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,cAAsB,EACtB,iBAA0C,EAC1C,OAA0B;IAE1B,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,iBAAiB,IAAI,EAAE,CAAC;IAChE,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAA,kBAAW,EAAC,IAAI,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC;IACtE,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,cAAc,CAAC,CAAC;IACrD,IAAI,IAA6B,CAAC;IAElC,IAAI,QAAQ,EAAE;QACZ,IAAI,CAAC,UAAU,EAAE;YACf,IAAI,GAAG,OAAO,CAAC;SAChB;aAAM,IAAI,IAAA,eAAiB,EAAC,cAAc,EAAE,UAAU,CAAC,EAAE;YACxD,IAAI,GAAG,IAAA,iBAAgB,EAAC,cAAc,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC;SAClE;aAAM,IAAI,QAAQ,CAAC,KAAK,KAAK,yBAAY,EAAE;YAC1C,IAAI,GAAG,SAAS,CAAC;SAClB;KACF;IAED,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAtBD,0CAsBC"}

package/lib/compare-and-publish/get-arguments.d.ts

@@ -0,0 +1,21 @@
+import type { NormalizedOptions } from "../normalize-options.js";
+/**
+ * Given a package name and publish configuration, get the NPM CLI view
+ * arguments.
+ *
+ * @param packageName Package name.
+ * @param options Publish configuration.
+ * @param retryWithTag Include a non-latest tag in the package spec for a rety
+ *   attempt.
+ * @returns Arguments to pass to the NPM CLI. If `retryWithTag` is true, but the
+ *   publish config is using the `latest` tag, will return `undefined`.
+ */
+export declare function getViewArguments(packageName: string, options: NormalizedOptions, retryWithTag?: boolean): string[];
+/**
+ * Given a publish configuration, get the NPM CLI publish arguments.
+ *
+ * @param packageSpec Package specification path.
+ * @param options Publish configuration.
+ * @returns Arguments to pass to the NPM CLI.
+ */
+export declare function getPublishArguments(packageSpec: string, options: NormalizedOptions): string[];

package/lib/compare-and-publish/get-arguments.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPublishArguments = exports.getViewArguments = void 0;
+/**
+ * Given a package name and publish configuration, get the NPM CLI view
+ * arguments.
+ *
+ * @param packageName Package name.
+ * @param options Publish configuration.
+ * @param retryWithTag Include a non-latest tag in the package spec for a rety
+ *   attempt.
+ * @returns Arguments to pass to the NPM CLI. If `retryWithTag` is true, but the
+ *   publish config is using the `latest` tag, will return `undefined`.
+ */
+function getViewArguments(packageName, options, retryWithTag = false) {
+    const packageSpec = retryWithTag
+        ? `${packageName}@${options.tag.value}`
+        : packageName;
+    return [packageSpec, "dist-tags", "versions"];
+}
+exports.getViewArguments = getViewArguments;
+/**
+ * Given a publish configuration, get the NPM CLI publish arguments.
+ *
+ * @param packageSpec Package specification path.
+ * @param options Publish configuration.
+ * @returns Arguments to pass to the NPM CLI.
+ */
+function getPublishArguments(packageSpec, options) {
+    const { tag, access, dryRun, provenance } = options;
+    const publishArguments = [];
+    if (packageSpec.length > 0) {
+        publishArguments.push(packageSpec);
+    }
+    if (!tag.isDefault) {
+        publishArguments.push("--tag", tag.value);
+    }
+    if (!access.isDefault && access.value) {
+        publishArguments.push("--access", access.value);
+    }
+    if (!provenance.isDefault && provenance.value) {
+        publishArguments.push("--provenance");
+    }
+    if (!dryRun.isDefault && dryRun.value) {
+        publishArguments.push("--dry-run");
+    }
+    return publishArguments;
+}
+exports.getPublishArguments = getPublishArguments;
+//# sourceMappingURL=get-arguments.js.map

package/lib/compare-and-publish/get-arguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-arguments.js","sourceRoot":"","sources":["../../src/compare-and-publish/get-arguments.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;GAUG;AACH,SAAgB,gBAAgB,CAC9B,WAAmB,EACnB,OAA0B,EAC1B,YAAY,GAAG,KAAK;IAEpB,MAAM,WAAW,GAAG,YAAY;QAC9B,CAAC,CAAC,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE;QACvC,CAAC,CAAC,WAAW,CAAC;IAEhB,OAAO,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAVD,4CAUC;AAED;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,OAA0B;IAE1B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IACpD,MAAM,gBAAgB,GAAG,EAAE,CAAC;IAE5B,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;QAC1B,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KACpC;IAED,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE;QAClB,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC;KAC3C;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE;QACrC,gBAAgB,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;KACjD;IAED,IAAI,CAAC,UAAU,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,EAAE;QAC7C,gBAAgB,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;KACvC;IAED,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,KAAK,EAAE;QACrC,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KACpC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AA5BD,kDA4BC"}

package/lib/compare-and-publish/index.d.ts

@@ -0,0 +1 @@
+export * from "./compare-and-publish.js";

package/lib/compare-and-publish/index.js

@@ -0,0 +1,18 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./compare-and-publish.js"), exports);
+//# sourceMappingURL=index.js.map

package/lib/compare-and-publish/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/compare-and-publish/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC"}

package/lib/errors.d.ts

@@ -0,0 +1,39 @@
+export declare class InvalidPackageError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class PackageJsonReadError extends Error {
+    constructor(manifestPath: string, originalError: unknown);
+}
+export declare class PackageTarballReadError extends Error {
+    constructor(tarballPath: string, originalError: unknown);
+}
+export declare class PackageJsonParseError extends SyntaxError {
+    constructor(packageSpec: string, originalError: unknown);
+}
+export declare class InvalidPackageNameError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidPackageVersionError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidPackagePublishConfigError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidRegistryUrlError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidTokenError extends TypeError {
+    constructor();
+}
+export declare class InvalidTagError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidAccessError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class InvalidStrategyError extends TypeError {
+    constructor(value: unknown);
+}
+export declare class NpmCallError extends Error {
+    constructor(command: string, exitCode: number, stderr: string);
+}

package/lib/errors.js

@@ -0,0 +1,121 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NpmCallError = exports.InvalidStrategyError = exports.InvalidAccessError = exports.InvalidTagError = exports.InvalidTokenError = exports.InvalidRegistryUrlError = exports.InvalidPackagePublishConfigError = exports.InvalidPackageVersionError = exports.InvalidPackageNameError = exports.PackageJsonParseError = exports.PackageTarballReadError = exports.PackageJsonReadError = exports.InvalidPackageError = void 0;
+const node_os_1 = __importDefault(require("node:os"));
+const options_js_1 = require("./options.js");
+class InvalidPackageError extends TypeError {
+    constructor(value) {
+        super(`Package must be a directory, package.json, or .tgz file, got "${String(value)}"`);
+        this.name = "PackageJsonReadError";
+    }
+}
+exports.InvalidPackageError = InvalidPackageError;
+class PackageJsonReadError extends Error {
+    constructor(manifestPath, originalError) {
+        const message = [
+            `Could not read package.json at ${manifestPath}`,
+            originalError instanceof Error ? originalError.message : "",
+        ]
+            .filter(Boolean)
+            .join(node_os_1.default.EOL);
+        super(message);
+        this.name = "PackageJsonReadError";
+    }
+}
+exports.PackageJsonReadError = PackageJsonReadError;
+class PackageTarballReadError extends Error {
+    constructor(tarballPath, originalError) {
+        const message = [
+            `Could not read package.json from ${tarballPath}`,
+            originalError instanceof Error ? originalError.message : "",
+        ]
+            .filter(Boolean)
+            .join(node_os_1.default.EOL);
+        super(message);
+        this.name = "PackageTarballReadError";
+    }
+}
+exports.PackageTarballReadError = PackageTarballReadError;
+class PackageJsonParseError extends SyntaxError {
+    constructor(packageSpec, originalError) {
+        const message = [
+            `Invalid JSON, could not parse package.json for ${packageSpec}`,
+            originalError instanceof Error ? originalError.message : "",
+        ]
+            .filter(Boolean)
+            .join(node_os_1.default.EOL);
+        super(message);
+        this.name = "PackageJsonParseError";
+    }
+}
+exports.PackageJsonParseError = PackageJsonParseError;
+class InvalidPackageNameError extends TypeError {
+    constructor(value) {
+        super(`Package name must be a string, got "${String(value)}"`);
+        this.name = "InvalidPackageNameError";
+    }
+}
+exports.InvalidPackageNameError = InvalidPackageNameError;
+class InvalidPackageVersionError extends TypeError {
+    constructor(value) {
+        super(`Package version must be a string, got "${String(value)}"`);
+        this.name = "InvalidPackageVersionError";
+    }
+}
+exports.InvalidPackageVersionError = InvalidPackageVersionError;
+class InvalidPackagePublishConfigError extends TypeError {
+    constructor(value) {
+        super(`Publish config must be an object, got "${String(value)}"`);
+        this.name = "InvalidPackagePublishConfigError";
+    }
+}
+exports.InvalidPackagePublishConfigError = InvalidPackagePublishConfigError;
+class InvalidRegistryUrlError extends TypeError {
+    constructor(value) {
+        super(`Registry URL invalid, got "${String(value)}"`);
+        this.name = "InvalidRegistryUrlError";
+    }
+}
+exports.InvalidRegistryUrlError = InvalidRegistryUrlError;
+class InvalidTokenError extends TypeError {
+    constructor() {
+        super("Token must be a non-empty string.");
+        this.name = "InvalidTokenError";
+    }
+}
+exports.InvalidTokenError = InvalidTokenError;
+class InvalidTagError extends TypeError {
+    constructor(value) {
+        super(`Tag must be a non-empty string, got "${String(value)}".`);
+        this.name = "InvalidTagError";
+    }
+}
+exports.InvalidTagError = InvalidTagError;
+class InvalidAccessError extends TypeError {
+    constructor(value) {
+        super(`Access must be "${options_js_1.ACCESS_PUBLIC}" or "${options_js_1.ACCESS_RESTRICTED}", got "${String(value)}".`);
+        this.name = "InvalidAccessError";
+    }
+}
+exports.InvalidAccessError = InvalidAccessError;
+class InvalidStrategyError extends TypeError {
+    constructor(value) {
+        super(`Strategy must be "${options_js_1.STRATEGY_UPGRADE}" or "${options_js_1.STRATEGY_ALL}", got "${String(value)}".`);
+        this.name = "InvalidStrategyError";
+    }
+}
+exports.InvalidStrategyError = InvalidStrategyError;
+class NpmCallError extends Error {
+    constructor(command, exitCode, stderr) {
+        super([
+            `Call to "npm ${command}" exited with non-zero exit code ${exitCode}`,
+            stderr,
+        ].join(node_os_1.default.EOL));
+        this.name = "NpmCallError";
+    }
+}
+exports.NpmCallError = NpmCallError;
+//# sourceMappingURL=errors.js.map

package/lib/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/lib/format-publish-result.d.ts

@@ -0,0 +1,12 @@
+import type { PublishResult } from "./compare-and-publish/index.js";
+import type { PackageManifest } from "./read-manifest.js";
+import type { NormalizedOptions } from "./normalize-options.js";
+/**
+ * Format publish results into a string.
+ *
+ * @param manifest Package manifest
+ * @param options Configuration options.
+ * @param result Results from running npm publish.
+ * @returns Formatted string.
+ */
+export declare function formatPublishResult(manifest: PackageManifest, options: NormalizedOptions, result: PublishResult): string;