@jsdevtools/npm-publish 2.0.0 → 2.2.0

package/lib/errors.js

@@ -3,7 +3,7 @@ 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.InvalidTokenError = exports.InvalidRegistryUrlError = exports.InvalidPackagePublishConfigError = exports.InvalidPackageVersionError = exports.InvalidPackageNameError = exports.PackageJsonParseError = exports.PackageTarballReadError = exports.PackageJsonReadError = exports.InvalidPackageError = void 0;
+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 {
@@ -87,6 +87,13 @@ class InvalidTokenError extends TypeError {
     }
 }
 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)}".`);

package/lib/errors.js.map

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

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

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

package/lib/format-publish-result.js

@@ -10,17 +10,17 @@ const node_os_1 = __importDefault(require("node:os"));
  *
  * @param manifest Package manifest
  * @param options Configuration options.
- * @param results Results from running npm publish.
+ * @param result Results from running npm publish.
  * @returns Formatted string.
  */
-function formatPublishResult(manifest, options, results) {
-    if (results === undefined) {
+function formatPublishResult(manifest, options, result) {
+    if (result.id === undefined) {
         return `🙅‍♀️ ${manifest.name}@${manifest.version} publish skipped.`;
     }
     return [
-        `📦 ${results.id}${options.dryRun.value ? " (DRY RUN)" : ""}`,
+        `📦 ${result.id}${options.dryRun.value ? " (DRY RUN)" : ""}`,
         "=== Contents ===",
-        ...results.files.map(({ path, size }) => `${formatSize(size)}\t${path}`),
+        ...result.files.map(({ path, size }) => `${formatSize(size)}\t${path}`),
     ].join(node_os_1.default.EOL);
 }
 exports.formatPublishResult = formatPublishResult;

package/lib/format-publish-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"format-publish-result.js","sourceRoot":"","sources":["../src/format-publish-result.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAMzB;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,QAAyB,EACzB,OAA0B,EAC1B,OAAuB;IAEvB,IAAI,OAAO,KAAK,SAAS,EAAE;QACzB,OAAO,SAAS,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,mBAAmB,CAAC;KACtE;IAED,OAAO;QACL,MAAM,OAAO,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;QAC7D,kBAAkB;QAClB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;KACzE,CAAC,IAAI,CAAC,iBAAE,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC;AAdD,kDAcC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAC1C,IAAI,IAAI,GAAG,IAAI,EAAE;QACf,OAAO,GAAG,IAAI,IAAI,CAAC;KACpB;IACD,IAAI,IAAI,GAAG,OAAS,EAAE;QACpB,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;KACzC;IAED,OAAO,GAAG,CAAC,IAAI,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC,CAAC"}
+{"version":3,"file":"format-publish-result.js","sourceRoot":"","sources":["../src/format-publish-result.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAyB;AAMzB;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,QAAyB,EACzB,OAA0B,EAC1B,MAAqB;IAErB,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS,EAAE;QAC3B,OAAO,SAAS,QAAQ,CAAC,IAAI,IAAI,QAAQ,CAAC,OAAO,mBAAmB,CAAC;KACtE;IAED,OAAO;QACL,MAAM,MAAM,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5D,kBAAkB;QAClB,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;KACxE,CAAC,IAAI,CAAC,iBAAE,CAAC,GAAG,CAAC,CAAC;AACjB,CAAC;AAdD,kDAcC;AAED,MAAM,UAAU,GAAG,CAAC,IAAY,EAAU,EAAE;IAC1C,IAAI,IAAI,GAAG,IAAI,EAAE;QACf,OAAO,GAAG,IAAI,IAAI,CAAC;KACpB;IACD,IAAI,IAAI,GAAG,OAAS,EAAE;QACpB,OAAO,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;KACzC;IAED,OAAO,GAAG,CAAC,IAAI,GAAG,OAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AAC/C,CAAC,CAAC"}

package/lib/normalize-options.d.ts

@@ -1,11 +1,14 @@
 import type { PackageManifest } from "./read-manifest.js";
 import { type Access, type Strategy, type Options, type Logger } from "./options.js";
+export declare const TAG_LATEST = "latest";
 /** Normalized and sanitized auth, publish, and runtime configurations. */
 export interface NormalizedOptions {
     registry: URL;
     token: string;
     tag: ConfigValue<string>;
     access: ConfigValue<Access | undefined>;
+    provenance: ConfigValue<boolean>;
+    ignoreScripts: ConfigValue<boolean>;
     dryRun: ConfigValue<boolean>;
     strategy: ConfigValue<Strategy>;
     logger: Logger | undefined;
@@ -19,8 +22,8 @@ export interface ConfigValue<TValue> {
 /**
  * Normalizes and sanitizes options, and fills-in any default values.
  *
- * @param options User-input options.
  * @param manifest Package metadata from package.json.
+ * @param options User-input options.
  * @returns Validated auth and publish configuration.
  */
-export declare function normalizeOptions(options: Options, manifest: PackageManifest): NormalizedOptions;
+export declare function normalizeOptions(manifest: PackageManifest, options: Options): NormalizedOptions;

package/lib/normalize-options.js

@@ -26,30 +26,33 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.normalizeOptions = void 0;
+exports.normalizeOptions = exports.TAG_LATEST = void 0;
 const node_os_1 = __importDefault(require("node:os"));
 const errors = __importStar(require("./errors.js"));
 const options_js_1 = require("./options.js");
-const DEFAULT_REGISTRY = "https://registry.npmjs.org/";
-const DEFAULT_TAG = "latest";
+const REGISTRY_NPM = "https://registry.npmjs.org/";
+exports.TAG_LATEST = "latest";
 /**
  * Normalizes and sanitizes options, and fills-in any default values.
  *
- * @param options User-input options.
  * @param manifest Package metadata from package.json.
+ * @param options User-input options.
  * @returns Validated auth and publish configuration.
  */
-function normalizeOptions(options, manifest) {
-    const defaultTag = manifest.publishConfig?.tag ?? DEFAULT_TAG;
-    const defaultRegistry = manifest.publishConfig?.registry ?? DEFAULT_REGISTRY;
+function normalizeOptions(manifest, options) {
+    const defaultTag = manifest.publishConfig?.tag ?? exports.TAG_LATEST;
+    const defaultRegistry = manifest.publishConfig?.registry ?? REGISTRY_NPM;
     const defaultAccess = manifest.publishConfig?.access ??
         (manifest.scope === undefined ? options_js_1.ACCESS_PUBLIC : undefined);
+    const defaultProvenance = manifest.publishConfig?.provenance ?? false;
     return {
         token: validateToken(options.token),
         registry: validateRegistry(options.registry ?? defaultRegistry),
         tag: setValue(options.tag, defaultTag, validateTag),
         access: setValue(options.access, defaultAccess, validateAccess),
-        dryRun: setValue(options.dryRun, false, validateDryRun),
+        provenance: setValue(options.provenance, defaultProvenance, Boolean),
+        ignoreScripts: setValue(options.ignoreScripts, true, Boolean),
+        dryRun: setValue(options.dryRun, false, Boolean),
         strategy: setValue(options.strategy, options_js_1.STRATEGY_ALL, validateStrategy),
         logger: options.logger,
         temporaryDirectory: options.temporaryDirectory ?? node_os_1.default.tmpdir(),
@@ -75,10 +78,10 @@ const validateRegistry = (value) => {
     }
 };
 const validateTag = (value) => {
-    return value;
-};
-const validateDryRun = (value) => {
-    return value;
+    if (typeof value === "string" && value.length > 0) {
+        return value;
+    }
+    throw new errors.InvalidTagError(value);
 };
 const validateAccess = (value) => {
     if (value === undefined ||

package/lib/normalize-options.js.map

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

package/lib/npm/call-npm-cli.d.ts

@@ -1,10 +1,32 @@
 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 declare const VIEW = "view";
+export declare const PUBLISH = "publish";
+export declare const E404 = "E404";
+export declare const EPUBLISHCONFLICT = "EPUBLISHCONFLICT";
 /**
  * Call the NPM CLI in JSON mode.
  *
@@ -13,4 +35,5 @@ export interface NpmCliOptions<TReturn> {
  * @param options Customize environment variables or add an error handler.
  * @returns The parsed JSON, or stdout if unparsable.
  */
-export declare function callNpmCli<TReturn = string>(command: string, cliArguments: string[], options?: NpmCliOptions<TReturn>): Promise<TReturn>;
+export declare function callNpmCli<CommandT extends Command>(command: CommandT, cliArguments: string[], options: NpmCliOptions): Promise<NpmCallResult<CommandT>>;
+export {};

package/lib/npm/call-npm-cli.js

@@ -26,13 +26,50 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.callNpmCli = void 0;
+exports.callNpmCli = exports.EPUBLISHCONFLICT = exports.E404 = exports.PUBLISH = exports.VIEW = void 0;
 const node_child_process_1 = __importDefault(require("node:child_process"));
 const node_os_1 = __importDefault(require("node:os"));
 const errors = __importStar(require("../errors.js"));
+exports.VIEW = "view";
+exports.PUBLISH = "publish";
+exports.E404 = "E404";
+exports.EPUBLISHCONFLICT = "EPUBLISHCONFLICT";
 const NPM = node_os_1.default.platform() === "win32" ? "npm.cmd" : "npm";
 const JSON_MATCH_RE = /(\{[\s\S]*\})/mu;
-const execNpm = (commandArguments, environment = {}, logger) => {
+const baseArguments = (options) => 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.
+ */
+async function callNpmCli(command, cliArguments, options) {
+    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(stdout);
+    }
+    else {
+        const errorPayload = parseJson(stdout, stderr);
+        errorCode = errorPayload?.error?.code?.toUpperCase();
+        error = new errors.NpmCallError(command, exitCode, stderr);
+    }
+    return { successData, errorCode, error };
+}
+exports.callNpmCli = callNpmCli;
+/**
+ * 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, environment, logger) {
     logger?.debug?.(`Running command: ${NPM} ${commandArguments.join(" ")}`);
     return new Promise((resolve) => {
         let stdout = "";
@@ -50,8 +87,17 @@ const execNpm = (commandArguments, environment = {}, logger) => {
             });
         });
     });
-};
-const parseJson = (...values) => {
+}
+/**
+ * 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(...values) {
     for (const value of values) {
         const jsonValue = JSON_MATCH_RE.exec(value)?.[1];
         if (jsonValue) {
@@ -64,28 +110,5 @@ const parseJson = (...values) => {
         }
     }
     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.
- */
-async function callNpmCli(command, cliArguments, options = {}) {
-    const { stdout, stderr, exitCode } = await execNpm([command, "--ignore-scripts", "--json", ...cliArguments], options.environment, options.logger);
-    if (exitCode !== 0) {
-        const errorPayload = parseJson(stdout, stderr);
-        const errorCode = errorPayload?.error?.code?.toLowerCase();
-        if (typeof errorCode === "string" &&
-            options.ifError &&
-            errorCode in options.ifError) {
-            return options.ifError[errorCode];
-        }
-        throw new errors.NpmCallError(command, exitCode, stderr);
-    }
-    return parseJson(stdout) ?? stdout;
 }
-exports.callNpmCli = callNpmCli;
 //# sourceMappingURL=call-npm-cli.js.map

package/lib/npm/call-npm-cli.js.map

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

package/lib/npm/index.d.ts

@@ -1,29 +1,2 @@
-import type { NormalizedOptions } from "../normalize-options.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 declare function getVersions(packageName: string, options: NormalizedOptions): Promise<PublishedVersions>;
-/**
- * Publish a package.
- *
- * @param packageSpec Package specification to pass to npm.
- * @param options Configuration options.
- * @returns Release metadata.
- */
-export declare function publish(packageSpec: string, options: NormalizedOptions): Promise<PublishResult>;
+export * from "./call-npm-cli.js";
+export * from "./use-npm-environment.js";

package/lib/npm/index.js

@@ -1,41 +1,19 @@
 "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 });
-exports.publish = exports.getVersions = void 0;
-const use_npm_environment_js_1 = require("./use-npm-environment.js");
-const call_npm_cli_js_1 = require("./call-npm-cli.js");
-const get_publish_arguments_js_1 = require("./get-publish-arguments.js");
-/**
- * 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.
- */
-async function getVersions(packageName, options) {
-    return (0, use_npm_environment_js_1.useNpmEnvironment)(options, (environment) => {
-        return (0, call_npm_cli_js_1.callNpmCli)("view", [packageName, "dist-tags", "versions"], {
-            logger: options.logger,
-            environment,
-            ifError: { e404: { "dist-tags": {}, versions: [] } },
-        });
-    });
-}
-exports.getVersions = getVersions;
-/**
- * Publish a package.
- *
- * @param packageSpec Package specification to pass to npm.
- * @param options Configuration options.
- * @returns Release metadata.
- */
-async function publish(packageSpec, options) {
-    const publishArguments = (0, get_publish_arguments_js_1.getPublishArguments)(packageSpec, options);
-    return (0, use_npm_environment_js_1.useNpmEnvironment)(options, (environment) => {
-        return (0, call_npm_cli_js_1.callNpmCli)("publish", publishArguments, {
-            logger: options.logger,
-            environment,
-        });
-    });
-}
-exports.publish = publish;
+__exportStar(require("./call-npm-cli.js"), exports);
+__exportStar(require("./use-npm-environment.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/npm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/npm/index.ts"],"names":[],"mappings":";;;AACA,qEAA6D;AAC7D,uDAA+C;AAC/C,yEAAiE;AAiBjE;;;;;;GAMG;AACI,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAA0B;IAE1B,OAAO,IAAA,0CAAiB,EAAC,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE;QAChD,OAAO,IAAA,4BAAU,EACf,MAAM,EACN,CAAC,WAAW,EAAE,WAAW,EAAE,UAAU,CAAC,EACtC;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW;YACX,OAAO,EAAE,EAAE,IAAI,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE;SACrD,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAfD,kCAeC;AAED;;;;;;GAMG;AACI,KAAK,UAAU,OAAO,CAC3B,WAAmB,EACnB,OAA0B;IAE1B,MAAM,gBAAgB,GAAG,IAAA,8CAAmB,EAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAEnE,OAAO,IAAA,0CAAiB,EAAC,OAAO,EAAE,CAAC,WAAW,EAAE,EAAE;QAChD,OAAO,IAAA,4BAAU,EAAgB,SAAS,EAAE,gBAAgB,EAAE;YAC5D,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,WAAW;SACZ,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAZD,0BAYC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/npm/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAkC;AAClC,2DAAyC"}

package/lib/npm/use-npm-environment.d.ts

@@ -1,13 +1,15 @@
+import type { PackageManifest } from "../read-manifest.js";
 import type { NormalizedOptions } from "../normalize-options.js";
 export type NpmCliEnvironment = Record<string, string>;
-export type NpmCliTask<TReturn> = (environment: NpmCliEnvironment) => Promise<TReturn>;
+export type NpmCliTask<TReturn> = (manifest: PackageManifest, options: NormalizedOptions, environment: NpmCliEnvironment) => Promise<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 declare function useNpmEnvironment<TReturn>(options: NormalizedOptions, task: NpmCliTask<TReturn>): Promise<TReturn>;
+export declare function useNpmEnvironment<TReturn>(manifest: PackageManifest, options: NormalizedOptions, task: NpmCliTask<TReturn>): Promise<TReturn>;

package/lib/npm/use-npm-environment.js

@@ -11,15 +11,20 @@ const node_path_1 = __importDefault(require("node:path"));
  * 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`
  */
-async function useNpmEnvironment(options, task) {
+async function useNpmEnvironment(manifest, options, task) {
     const { registry, token, logger, temporaryDirectory } = options;
     const npmrcDirectory = await promises_1.default.mkdtemp(node_path_1.default.join(temporaryDirectory, "npm-publish-"));
     const npmrc = node_path_1.default.join(npmrcDirectory, ".npmrc");
+    const environment = {
+        NODE_AUTH_TOKEN: token,
+        npm_config_userconfig: npmrc,
+    };
     const config = [
         "; created by jsdevtools/npm-publish",
         `//${registry.host}/:_authToken=\${NODE_AUTH_TOKEN}`,
@@ -29,10 +34,7 @@ async function useNpmEnvironment(options, task) {
     await promises_1.default.writeFile(npmrc, config, "utf8");
     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 promises_1.default.rm(npmrcDirectory, { force: true, recursive: true });

package/lib/npm/use-npm-environment.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-npm-environment.js","sourceRoot":"","sources":["../../src/npm/use-npm-environment.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAU7B;;;;;;;;GAQG;AACI,KAAK,UAAU,iBAAiB,CACrC,OAA0B,EAC1B,IAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC;IAChE,MAAM,cAAc,GAAG,MAAM,kBAAE,CAAC,OAAO,CACrC,mBAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAC9C,CAAC;IACF,MAAM,KAAK,GAAG,mBAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAElD,MAAM,MAAM,GAAG;QACb,qCAAqC;QACrC,KAAK,QAAQ,CAAC,IAAI,kCAAkC;QACpD,YAAY,QAAQ,CAAC,IAAI,EAAE;QAC3B,EAAE;KACH,CAAC,IAAI,CAAC,iBAAE,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,kBAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,EAAE,KAAK,EAAE,CAAC,+BAA+B,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IAEnE,IAAI;QACF,OAAO,MAAM,IAAI,CAAC;YAChB,eAAe,EAAE,KAAK;YACtB,qBAAqB,EAAE,KAAK;SAC7B,CAAC,CAAC;KACJ;YAAS;QACR,MAAM,kBAAE,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/D;AACH,CAAC;AA7BD,8CA6BC"}
+{"version":3,"file":"use-npm-environment.js","sourceRoot":"","sources":["../../src/npm/use-npm-environment.ts"],"names":[],"mappings":";;;;;;AAAA,gEAAkC;AAClC,sDAAyB;AACzB,0DAA6B;AAa7B;;;;;;;;;GASG;AACI,KAAK,UAAU,iBAAiB,CACrC,QAAyB,EACzB,OAA0B,EAC1B,IAAyB;IAEzB,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,GAAG,OAAO,CAAC;IAChE,MAAM,cAAc,GAAG,MAAM,kBAAE,CAAC,OAAO,CACrC,mBAAI,CAAC,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAC9C,CAAC;IACF,MAAM,KAAK,GAAG,mBAAI,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,CAAC;IAClD,MAAM,WAAW,GAAG;QAClB,eAAe,EAAE,KAAK;QACtB,qBAAqB,EAAE,KAAK;KAC7B,CAAC;IAEF,MAAM,MAAM,GAAG;QACb,qCAAqC;QACrC,KAAK,QAAQ,CAAC,IAAI,kCAAkC;QACpD,YAAY,QAAQ,CAAC,IAAI,EAAE;QAC3B,EAAE;KACH,CAAC,IAAI,CAAC,iBAAE,CAAC,GAAG,CAAC,CAAC;IAEf,MAAM,kBAAE,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1C,MAAM,EAAE,KAAK,EAAE,CAAC,+BAA+B,KAAK,KAAK,MAAM,EAAE,CAAC,CAAC;IAEnE,IAAI;QACF,OAAO,MAAM,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,WAAW,CAAC,CAAC;KACnD;YAAS;QACR,MAAM,kBAAE,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;KAC/D;AACH,CAAC;AA/BD,8CA+BC"}

package/lib/npm-publish.js

@@ -4,7 +4,7 @@ exports.npmPublish = void 0;
 const read_manifest_js_1 = require("./read-manifest.js");
 const normalize_options_js_1 = require("./normalize-options.js");
 const index_js_1 = require("./npm/index.js");
-const compare_versions_js_1 = require("./compare-versions.js");
+const index_js_2 = require("./compare-and-publish/index.js");
 const format_publish_result_js_1 = require("./format-publish-result.js");
 /**
  * Publishes a package to NPM, if its version has changed.
@@ -13,21 +13,16 @@ const format_publish_result_js_1 = require("./format-publish-result.js");
  * @returns Release metadata.
  */
 async function npmPublish(options) {
-    const { packageSpec, manifest } = await (0, read_manifest_js_1.readManifest)(options.package);
-    const normalizedOptions = (0, normalize_options_js_1.normalizeOptions)(options, manifest);
-    const publishedVersions = await (0, index_js_1.getVersions)(manifest.name, normalizedOptions);
-    const versionComparison = (0, compare_versions_js_1.compareVersions)(manifest.version, publishedVersions, normalizedOptions);
-    let publishResult;
-    if (versionComparison.type !== undefined) {
-        publishResult = await (0, index_js_1.publish)(packageSpec, normalizedOptions);
-    }
+    const manifest = await (0, read_manifest_js_1.readManifest)(options.package);
+    const normalizedOptions = (0, normalize_options_js_1.normalizeOptions)(manifest, options);
+    const publishResult = await (0, index_js_1.useNpmEnvironment)(manifest, normalizedOptions, index_js_2.compareAndPublish);
     normalizedOptions.logger?.info?.((0, format_publish_result_js_1.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/lib/npm-publish.js.map

@@ -1 +1 @@
-{"version":3,"file":"npm-publish.js","sourceRoot":"","sources":["../src/npm-publish.ts"],"names":[],"mappings":";;;AAAA,yDAAkD;AAClD,iEAA0D;AAC1D,6CAAsD;AACtD,+DAAwD;AACxD,yEAAiE;AAIjE;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,OAAgB;IAC/C,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAA,+BAAY,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACtE,MAAM,iBAAiB,GAAG,IAAA,uCAAgB,EAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,iBAAiB,GAAG,MAAM,IAAA,sBAAW,EAAC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC,CAAC;IAC9E,MAAM,iBAAiB,GAAG,IAAA,qCAAe,EACvC,QAAQ,CAAC,OAAO,EAChB,iBAAiB,EACjB,iBAAiB,CAClB,CAAC;IAEF,IAAI,aAAa,CAAC;IAElB,IAAI,iBAAiB,CAAC,IAAI,KAAK,SAAS,EAAE;QACxC,aAAa,GAAG,MAAM,IAAA,kBAAO,EAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;KAC/D;IAED,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,CAC9B,IAAA,8CAAmB,EAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAChE,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,aAAa,EAAE,EAAE;QACrB,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,IAAI,EAAE,iBAAiB,CAAC,IAAI;QAC5B,UAAU,EAAE,iBAAiB,CAAC,UAAU;QACxC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;QACpC,GAAG,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK;QAChC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK;QACtC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,KAAK;QAC1C,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK;KACvC,CAAC;AACJ,CAAC;AAhCD,gCAgCC"}
+{"version":3,"file":"npm-publish.js","sourceRoot":"","sources":["../src/npm-publish.ts"],"names":[],"mappings":";;;AAAA,yDAAkD;AAClD,iEAA0D;AAC1D,6CAAmD;AACnD,6DAAmE;AACnE,yEAAiE;AAIjE;;;;;GAKG;AACI,KAAK,UAAU,UAAU,CAAC,OAAgB;IAC/C,MAAM,QAAQ,GAAG,MAAM,IAAA,+BAAY,EAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrD,MAAM,iBAAiB,GAAG,IAAA,uCAAgB,EAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,aAAa,GAAG,MAAM,IAAA,4BAAiB,EAC3C,QAAQ,EACR,iBAAiB,EACjB,4BAAiB,CAClB,CAAC;IAEF,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,CAC9B,IAAA,8CAAmB,EAAC,QAAQ,EAAE,iBAAiB,EAAE,aAAa,CAAC,CAChE,CAAC;IAEF,OAAO;QACL,EAAE,EAAE,aAAa,CAAC,EAAE;QACpB,IAAI,EAAE,aAAa,CAAC,IAAI;QACxB,UAAU,EAAE,aAAa,CAAC,UAAU;QACpC,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,OAAO,EAAE,QAAQ,CAAC,OAAO;QACzB,QAAQ,EAAE,iBAAiB,CAAC,QAAQ;QACpC,GAAG,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK;QAChC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK;QACtC,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC,KAAK;QAC1C,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,KAAK;KACvC,CAAC;AACJ,CAAC;AAzBD,gCAyBC"}

package/lib/options.d.ts

@@ -34,7 +34,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;
     /**
@@ -42,7 +42,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;
     /**
@@ -53,21 +53,40 @@ 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.
      *
-     * 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.
+     * Defaults to `false`.
+     *
+     * 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.
      *