@jsdevtools/npm-publish 2.0.0 → 2.2.0

package/src/npm/call-npm-cli.ts

@@ -5,20 +5,97 @@ import * as errors from "../errors.js";
 import type { Logger } from "../options.js";
 import type { NpmCliEnvironment } from "./use-npm-environment.js";
 
-export interface NpmCliOptions<TReturn> {
-  environment?: NpmCliEnvironment;
-  ifError?: Record<string, TReturn>;
+export interface NpmCliOptions {
+  environment: NpmCliEnvironment;
+  ignoreScripts: boolean;
   logger?: Logger | undefined;
 }
 
+export interface NpmCallResult<CommandT extends Command> {
+  successData: SuccessData<CommandT> | undefined;
+  errorCode: string | undefined;
+  error: Error | undefined;
+}
+
+type SuccessData<T extends Command> = T extends typeof VIEW
+  ? NpmViewData
+  : T extends typeof PUBLISH
+  ? NpmPublishData
+  : unknown;
+
+export interface NpmViewData {
+  "dist-tags": Record<string, string>;
+  versions: string[];
+}
+export interface NpmPublishData {
+  id: string;
+  files: { path: string; size: number }[];
+}
+
+export type Command = typeof VIEW | typeof PUBLISH | string;
+export const VIEW = "view";
+export const PUBLISH = "publish";
+
+export const E404 = "E404";
+export const EPUBLISHCONFLICT = "EPUBLISHCONFLICT";
+
 const NPM = os.platform() === "win32" ? "npm.cmd" : "npm";
 const JSON_MATCH_RE = /(\{[\s\S]*\})/mu;
 
-const execNpm = (
+const baseArguments = (options: NpmCliOptions) =>
+  options.ignoreScripts ? ["--ignore-scripts", "--json"] : ["--json"];
+
+/**
+ * Call the NPM CLI in JSON mode.
+ *
+ * @param command The command of the NPM CLI to call
+ * @param cliArguments Any arguments to send to the command
+ * @param options Customize environment variables or add an error handler.
+ * @returns The parsed JSON, or stdout if unparsable.
+ */
+export async function callNpmCli<CommandT extends Command>(
+  command: CommandT,
+  cliArguments: string[],
+  options: NpmCliOptions
+): Promise<NpmCallResult<CommandT>> {
+  const { stdout, stderr, exitCode } = await execNpm(
+    [command, ...baseArguments(options), ...cliArguments],
+    options.environment,
+    options.logger
+  );
+
+  let successData;
+  let errorCode;
+  let error;
+
+  if (exitCode === 0) {
+    successData = parseJson<SuccessData<CommandT>>(stdout);
+  } else {
+    const errorPayload = parseJson<{ error?: { code?: string | null } }>(
+      stdout,
+      stderr
+    );
+
+    errorCode = errorPayload?.error?.code?.toUpperCase();
+    error = new errors.NpmCallError(command, exitCode, stderr);
+  }
+
+  return { successData, errorCode, error };
+}
+
+/**
+ * Execute the npm CLI.
+ *
+ * @param commandArguments Npm subcommand and arguments.
+ * @param environment Environment variables.
+ * @param logger Optional logger.
+ * @returns Stdout, stderr, and the exit code.
+ */
+async function execNpm(
   commandArguments: string[],
-  environment: Record<string, string> = {},
+  environment: Record<string, string>,
   logger?: Logger
-): Promise<{ stdout: string; stderr: string; exitCode: number }> => {
+): Promise<{ stdout: string; stderr: string; exitCode: number }> {
   logger?.debug?.(`Running command: ${NPM} ${commandArguments.join(" ")}`);
 
   return new Promise((resolve) => {
@@ -39,9 +116,18 @@ const execNpm = (
       });
     });
   });
-};
+}
 
-const parseJson = <TParsed>(...values: string[]): TParsed | undefined => {
+/**
+ * Parse CLI outputs for JSON data.
+ *
+ * Certain versions of the npm CLI may intersperse JSON with human-readable
+ * output, which this function accounts for.
+ *
+ * @param values CLI outputs to check
+ * @returns Parsed JSON, if able to parse.
+ */
+function parseJson<TParsed>(...values: string[]): TParsed | undefined {
   for (const value of values) {
     const jsonValue = JSON_MATCH_RE.exec(value)?.[1];
 
@@ -55,44 +141,4 @@ const parseJson = <TParsed>(...values: string[]): TParsed | undefined => {
   }
 
   return undefined;
-};
-
-/**
- * Call the NPM CLI in JSON mode.
- *
- * @param command The command of the NPM CLI to call
- * @param cliArguments Any arguments to send to the command
- * @param options Customize environment variables or add an error handler.
- * @returns The parsed JSON, or stdout if unparsable.
- */
-export async function callNpmCli<TReturn = string>(
-  command: string,
-  cliArguments: string[],
-  options: NpmCliOptions<TReturn> = {}
-): Promise<TReturn> {
-  const { stdout, stderr, exitCode } = await execNpm(
-    [command, "--ignore-scripts", "--json", ...cliArguments],
-    options.environment,
-    options.logger
-  );
-
-  if (exitCode !== 0) {
-    const errorPayload = parseJson<{ error?: { code?: string | null } }>(
-      stdout,
-      stderr
-    );
-    const errorCode = errorPayload?.error?.code?.toLowerCase();
-
-    if (
-      typeof errorCode === "string" &&
-      options.ifError &&
-      errorCode in options.ifError
-    ) {
-      return options.ifError[errorCode] as TReturn;
-    }
-
-    throw new errors.NpmCallError(command, exitCode, stderr);
-  }
-
-  return parseJson(stdout) ?? (stdout as unknown as TReturn);
 }

package/src/npm/index.ts

@@ -1,64 +1,2 @@
-import type { NormalizedOptions } from "../normalize-options.js";
-import { useNpmEnvironment } from "./use-npm-environment.js";
-import { callNpmCli } from "./call-npm-cli.js";
-import { getPublishArguments } from "./get-publish-arguments.js";
-
-export interface PublishedVersions {
-  "dist-tags": Record<string, string>;
-  versions: string[];
-}
-
-export interface PublishFile {
-  path: string;
-  size: number;
-}
-
-export interface PublishResult {
-  id: string;
-  files: PublishFile[];
-}
-
-/**
- * Get a package's published versions.
- *
- * @param packageName The name of the package to get published versions for.
- * @param options Configuration options.
- * @returns All published versions and tags.
- */
-export async function getVersions(
-  packageName: string,
-  options: NormalizedOptions
-): Promise<PublishedVersions> {
-  return useNpmEnvironment(options, (environment) => {
-    return callNpmCli<PublishedVersions>(
-      "view",
-      [packageName, "dist-tags", "versions"],
-      {
-        logger: options.logger,
-        environment,
-        ifError: { e404: { "dist-tags": {}, versions: [] } },
-      }
-    );
-  });
-}
-
-/**
- * Publish a package.
- *
- * @param packageSpec Package specification to pass to npm.
- * @param options Configuration options.
- * @returns Release metadata.
- */
-export async function publish(
-  packageSpec: string,
-  options: NormalizedOptions
-): Promise<PublishResult> {
-  const publishArguments = getPublishArguments(packageSpec, options);
-
-  return useNpmEnvironment(options, (environment) => {
-    return callNpmCli<PublishResult>("publish", publishArguments, {
-      logger: options.logger,
-      environment,
-    });
-  });
-}
+export * from "./call-npm-cli.js";
+export * from "./use-npm-environment.js";

package/src/npm/use-npm-environment.ts

@@ -2,11 +2,14 @@ import fs from "node:fs/promises";
 import os from "node:os";
 import path from "node:path";
 
+import type { PackageManifest } from "../read-manifest.js";
 import type { NormalizedOptions } from "../normalize-options.js";
 
 export type NpmCliEnvironment = Record<string, string>;
 
 export type NpmCliTask<TReturn> = (
+  manifest: PackageManifest,
+  options: NormalizedOptions,
   environment: NpmCliEnvironment
 ) => Promise<TReturn>;
 
@@ -14,12 +17,14 @@ export type NpmCliTask<TReturn> = (
  * Create a temporary .npmrc file with the given auth token, and call a task
  * with env vars set to use that .npmrc.
  *
+ * @param manifest Pacakge metadata.
  * @param options Configuration options.
  * @param task A function called with the configured environment. After the
  *   function resolves, the temporary .npmrc file will be removed.
  * @returns The resolved value of `task`
  */
 export async function useNpmEnvironment<TReturn>(
+  manifest: PackageManifest,
   options: NormalizedOptions,
   task: NpmCliTask<TReturn>
 ): Promise<TReturn> {
@@ -28,6 +33,10 @@ export async function useNpmEnvironment<TReturn>(
     path.join(temporaryDirectory, "npm-publish-")
   );
   const npmrc = path.join(npmrcDirectory, ".npmrc");
+  const environment = {
+    NODE_AUTH_TOKEN: token,
+    npm_config_userconfig: npmrc,
+  };
 
   const config = [
     "; created by jsdevtools/npm-publish",
@@ -41,10 +50,7 @@ export async function useNpmEnvironment<TReturn>(
   logger?.debug?.(`Temporary .npmrc created at ${npmrc}\n${config}`);
 
   try {
-    return await task({
-      NODE_AUTH_TOKEN: token,
-      npm_config_userconfig: npmrc,
-    });
+    return await task(manifest, options, environment);
   } finally {
     await fs.rm(npmrcDirectory, { force: true, recursive: true });
   }

package/src/npm-publish.ts

@@ -1,7 +1,7 @@
 import { readManifest } from "./read-manifest.js";
 import { normalizeOptions } from "./normalize-options.js";
-import { getVersions, publish } from "./npm/index.js";
-import { compareVersions } from "./compare-versions.js";
+import { useNpmEnvironment } from "./npm/index.js";
+import { compareAndPublish } from "./compare-and-publish/index.js";
 import { formatPublishResult } from "./format-publish-result.js";
 import type { Options } from "./options.js";
 import type { Results } from "./results.js";
@@ -13,31 +13,24 @@ import type { Results } from "./results.js";
  * @returns Release metadata.
  */
 export async function npmPublish(options: Options): Promise<Results> {
-  const { packageSpec, manifest } = await readManifest(options.package);
-  const normalizedOptions = normalizeOptions(options, manifest);
-  const publishedVersions = await getVersions(manifest.name, normalizedOptions);
-  const versionComparison = compareVersions(
-    manifest.version,
-    publishedVersions,
-    normalizedOptions
+  const manifest = await readManifest(options.package);
+  const normalizedOptions = normalizeOptions(manifest, options);
+  const publishResult = await useNpmEnvironment(
+    manifest,
+    normalizedOptions,
+    compareAndPublish
   );
 
-  let publishResult;
-
-  if (versionComparison.type !== undefined) {
-    publishResult = await publish(packageSpec, normalizedOptions);
-  }
-
   normalizedOptions.logger?.info?.(
     formatPublishResult(manifest, normalizedOptions, publishResult)
   );
 
   return {
-    id: publishResult?.id,
+    id: publishResult.id,
+    type: publishResult.type,
+    oldVersion: publishResult.oldVersion,
     name: manifest.name,
     version: manifest.version,
-    type: versionComparison.type,
-    oldVersion: versionComparison.oldVersion,
     registry: normalizedOptions.registry,
     tag: normalizedOptions.tag.value,
     access: normalizedOptions.access.value,

package/src/options.ts

@@ -39,7 +39,7 @@ export interface Options {
    *
    * Defaults to "https://registry.npmjs.org/".
    *
-   * Can be overridden by the package.json's `publishConfig` field.
+   * Can be set by the package.json's `publishConfig` field.
    */
   registry?: string | URL | undefined;
 
@@ -48,7 +48,7 @@ export interface Options {
    *
    * Defaults to "latest".
    *
-   * Can be overridden by the package.json's `publishConfig` field.
+   * Can be set by the package.json's `publishConfig` field.
    */
   tag?: string | undefined;
 
@@ -60,23 +60,44 @@ export interface Options {
    * packages.
    *
    * Defaults to "restricted" for scoped packages, unless that package has been
-   * previously published as `public`
+   * previously published as `public`.
    *
-   * Can be overridden by the package.json's `publishConfig` field.
+   * Can be set by the package.json's `publishConfig` field.
    */
   access?: Access | undefined;
 
   /**
-   * Version check strategy.
+   * Generate provenance statements.
+   *
+   * Publish must be run from a supported CI provider to succeed. When run from
+   * GitHub Actions, requires `id-token: write` permission.
+   *
+   * Defaults to `false`.
    *
-   * If "upgrade" (default), the package will only be published if its version
-   * is higher than the existing version on the configured tag. If "always", the
-   * package will be published if its version is simply not yet published.
+   * Can be set by the package.json's `publishConfig` field.
+   */
+  provenance?: boolean | undefined;
+
+  /**
+   * Version check strategy.
    *
-   * Defaults to `upgrade`.
+   * - `always` (default): the package will be published if its version is simply
+   *   not yet published.
+   * - `upgrade`: the package will only be published if its version is higher than
+   *   the existing version on the configured tag.
    */
   strategy?: Strategy | undefined;
 
+  /**
+   * Ignore lifecycle scripts.
+   *
+   * If `true` (default), `--ignore-scripts` will be passed to `npm`. If you
+   * rely on publish lifecycle scripts - i.e. `prepublishOnly`, `prepack`,
+   * `prepare`, `postpack`, `publish`, `postpublish` - you should set this to
+   * `false` or rework your build and publish workflow.
+   */
+  ignoreScripts?: boolean | undefined;
+
   /**
    * Pretend to publish, but don't actually upload to the registry.
    *

package/src/read-manifest.ts

@@ -5,14 +5,9 @@ import { list as tarList, type ReadEntry } from "tar";
 
 import * as errors from "./errors.js";
 
-/** The result of reading a package manifest */
-export interface ManifestReadResult {
-  packageSpec: string;
-  manifest: PackageManifest;
-}
-
-/** A package manifest (package.json) */
+/** A package manifest (package.json) and associated details. */
 export interface PackageManifest {
+  packageSpec: string;
   name: string;
   version: string;
   scope: string | undefined;
@@ -24,6 +19,7 @@ export interface PackagePublishConfig {
   tag?: string;
   access?: string;
   registry?: string;
+  provenance?: boolean;
 }
 
 const SCOPE_RE = /^(@.+)\/.+$/u;
@@ -86,7 +82,7 @@ const readTarballPackageJson = async (file: string): Promise<string> => {
  */
 export async function readManifest(
   packagePath: unknown
-): Promise<ManifestReadResult> {
+): Promise<PackageManifest> {
   let packageSpec: string | undefined;
   let manifestContents: string;
 
@@ -138,6 +134,9 @@ export async function readManifest(
 
   return {
     packageSpec,
-    manifest: { name, version, publishConfig, scope: SCOPE_RE.exec(name)?.[1] },
+    name,
+    version,
+    publishConfig,
+    scope: SCOPE_RE.exec(name)?.[1],
   };
 }

package/src/results.ts

@@ -1,5 +1,10 @@
 import type { Access, Strategy } from "./options.js";
-import type { ReleaseType } from "./compare-versions.js";
+import type { ReleaseType as SemverReleaseType } from "semver";
+
+/** Release type */
+export type ReleaseType = SemverReleaseType | typeof INITIAL | typeof DIFFERENT;
+export const INITIAL = "initial";
+export const DIFFERENT = "different";
 
 /** Results of the publish */
 export interface Results {

package/lib/compare-versions.d.ts

@@ -1,20 +0,0 @@
-import { type ReleaseType as SemverReleaseType } from "semver";
-import type { NormalizedOptions } from "./normalize-options.js";
-import type { PublishedVersions } from "./npm/index.js";
-export type ReleaseType = SemverReleaseType | typeof INITIAL | typeof DIFFERENT;
-export interface VersionComparison {
-    type: ReleaseType | undefined;
-    oldVersion: string | undefined;
-}
-declare const INITIAL = "initial";
-declare const DIFFERENT = "different";
-/**
- * Compare previously published versions with the package's current version.
- *
- * @param version 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(version: string, publishedVersions: PublishedVersions, options: NormalizedOptions): VersionComparison;
-export {};

package/lib/compare-versions.js

@@ -1,36 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.compareVersions = void 0;
-const semver_1 = require("semver");
-const options_js_1 = require("./options.js");
-const INITIAL = "initial";
-const DIFFERENT = "different";
-/**
- * Compare previously published versions with the package's current version.
- *
- * @param version 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(version, publishedVersions, options) {
-    const { versions: existingVersions, "dist-tags": tags } = publishedVersions;
-    const { strategy, tag: publishTag } = options;
-    const oldVersion = (0, semver_1.valid)(tags[publishTag.value]) ?? undefined;
-    const isUnique = !existingVersions.includes(version);
-    let type;
-    if (isUnique) {
-        if (!oldVersion) {
-            type = INITIAL;
-        }
-        else if ((0, semver_1.gt)(version, oldVersion)) {
-            type = (0, semver_1.diff)(version, 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-versions.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"compare-versions.js","sourceRoot":"","sources":["../src/compare-versions.ts"],"names":[],"mappings":";;;AAAA,mCAKgB;AAEhB,6CAA4C;AAW5C,MAAM,OAAO,GAAG,SAAS,CAAC;AAC1B,MAAM,SAAS,GAAG,WAAW,CAAC;AAE9B;;;;;;;GAOG;AACH,SAAgB,eAAe,CAC7B,OAAe,EACf,iBAAoC,EACpC,OAA0B;IAE1B,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,iBAAiB,CAAC;IAC5E,MAAM,EAAE,QAAQ,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAA,cAAW,EAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,IAAI,SAAS,CAAC;IACpE,MAAM,QAAQ,GAAG,CAAC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACrD,IAAI,IAA6B,CAAC;IAElC,IAAI,QAAQ,EAAE;QACZ,IAAI,CAAC,UAAU,EAAE;YACf,IAAI,GAAG,OAAO,CAAC;SAChB;aAAM,IAAI,IAAA,WAAiB,EAAC,OAAO,EAAE,UAAU,CAAC,EAAE;YACjD,IAAI,GAAG,IAAA,aAAgB,EAAC,OAAO,EAAE,UAAU,CAAC,IAAI,SAAS,CAAC;SAC3D;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/npm/get-publish-arguments.d.ts

@@ -1,9 +0,0 @@
-import type { NormalizedOptions } from "../normalize-options.js";
-/**
- * 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/npm/get-publish-arguments.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getPublishArguments = void 0;
-/**
- * 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 } = 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 (dryRun.value) {
-        publishArguments.push("--dry-run");
-    }
-    return publishArguments;
-}
-exports.getPublishArguments = getPublishArguments;
-//# sourceMappingURL=get-publish-arguments.js.map

package/lib/npm/get-publish-arguments.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"get-publish-arguments.js","sourceRoot":"","sources":["../../src/npm/get-publish-arguments.ts"],"names":[],"mappings":";;;AAEA;;;;;;GAMG;AACH,SAAgB,mBAAmB,CACjC,WAAmB,EACnB,OAA0B;IAE1B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACxC,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,MAAM,CAAC,KAAK,EAAE;QAChB,gBAAgB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;KACpC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC;AAxBD,kDAwBC"}

package/src/compare-versions.ts

@@ -1,52 +0,0 @@
-import {
-  valid as semverValid,
-  gt as semverGreaterThan,
-  diff as semverDifference,
-  type ReleaseType as SemverReleaseType,
-} from "semver";
-
-import { STRATEGY_ALL } from "./options.js";
-import type { NormalizedOptions } from "./normalize-options.js";
-import type { PublishedVersions } from "./npm/index.js";
-
-export type ReleaseType = SemverReleaseType | typeof INITIAL | typeof DIFFERENT;
-
-export interface VersionComparison {
-  type: ReleaseType | undefined;
-  oldVersion: string | undefined;
-}
-
-const INITIAL = "initial";
-const DIFFERENT = "different";
-
-/**
- * Compare previously published versions with the package's current version.
- *
- * @param version 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 function compareVersions(
-  version: string,
-  publishedVersions: PublishedVersions,
-  options: NormalizedOptions
-): VersionComparison {
-  const { versions: existingVersions, "dist-tags": tags } = publishedVersions;
-  const { strategy, tag: publishTag } = options;
-  const oldVersion = semverValid(tags[publishTag.value]) ?? undefined;
-  const isUnique = !existingVersions.includes(version);
-  let type: ReleaseType | undefined;
-
-  if (isUnique) {
-    if (!oldVersion) {
-      type = INITIAL;
-    } else if (semverGreaterThan(version, oldVersion)) {
-      type = semverDifference(version, oldVersion) ?? DIFFERENT;
-    } else if (strategy.value === STRATEGY_ALL) {
-      type = DIFFERENT;
-    }
-  }
-
-  return { type, oldVersion };
-}

package/src/npm/get-publish-arguments.ts

@@ -1,34 +0,0 @@
-import type { NormalizedOptions } from "../normalize-options.js";
-
-/**
- * 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 function getPublishArguments(
-  packageSpec: string,
-  options: NormalizedOptions
-): string[] {
-  const { tag, access, dryRun } = 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 (dryRun.value) {
-    publishArguments.push("--dry-run");
-  }
-
-  return publishArguments;
-}