@storm-software/workspace-tools 1.269.1 → 1.270.1

package/CHANGELOG.md

@@ -2,6 +2,63 @@
 
 # Changelog for Storm Ops - Workspace Tools
 
+## [1.270.1](https://github.com/storm-software/storm-ops/releases/tag/workspace-tools%401.270.1) (2025-05-06)
+
+### Bug Fixes
+
+- **workspace-tools:** Resolve issue with missing dependencies
+  ([e4fcafde0](https://github.com/storm-software/storm-ops/commit/e4fcafde0))
+
+### Miscellaneous
+
+- **monorepo:** Regenerate README markdown files
+  ([6eabb3ff1](https://github.com/storm-software/storm-ops/commit/6eabb3ff1))
+
+### Updated Dependencies
+
+- Updated prettier to 0.48.1
+- Updated esbuild to 0.38.1
+- Updated esbuild to 0.38.1
+- Updated unbuild to 0.44.1
+- Updated unbuild to 0.44.1
+
+## [1.270.0](https://github.com/storm-software/storm-ops/releases/tag/workspace-tools%401.270.0) (2025-05-06)
+
+### Features
+
+- **workspace-tools:** Update the publish executor source code
+  ([527dcfe84](https://github.com/storm-software/storm-ops/commit/527dcfe84))
+
+### Miscellaneous
+
+- **monorepo:** Regenerate README markdown files
+  ([d58a4014e](https://github.com/storm-software/storm-ops/commit/d58a4014e))
+
+### Updated Dependencies
+
+- Updated prettier to 0.48.0
+- Updated esbuild to 0.38.0
+- Updated esbuild to 0.38.0
+- Updated unbuild to 0.44.0
+- Updated unbuild to 0.44.0
+
+## [1.269.2](https://github.com/storm-software/storm-ops/releases/tag/workspace-tools%401.269.2) (2025-05-05)
+
+### Miscellaneous
+
+- **workspace-tools:** Skip git checks during publish
+  ([7fdcbfc9a](https://github.com/storm-software/storm-ops/commit/7fdcbfc9a))
+- **monorepo:** Regenerate README markdown files
+  ([fb8ab0609](https://github.com/storm-software/storm-ops/commit/fb8ab0609))
+
+### Updated Dependencies
+
+- Updated prettier to 0.47.2
+- Updated esbuild to 0.37.2
+- Updated esbuild to 0.37.2
+- Updated unbuild to 0.43.2
+- Updated unbuild to 0.43.2
+
 ## [1.269.1](https://github.com/storm-software/storm-ops/releases/tag/workspace-tools%401.269.1) (2025-05-05)
 
 ### Miscellaneous

package/README.md

@@ -21,7 +21,7 @@ This package is part of the <b>⚡Storm-Ops</b> monorepo. The Storm-Ops packages
 
 <h3 align="center">💻 Visit <a href="https://stormsoftware.com" target="_blank">stormsoftware.com</a> to stay up to date with this developer</h3><br />
 
-[![Version](https://img.shields.io/badge/version-1.269.0-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
+[![Version](https://img.shields.io/badge/version-1.269.2-1fb2a6.svg?style=for-the-badge&color=1fb2a6)](https://prettier.io/)&nbsp;[![Nx](https://img.shields.io/badge/Nx-17.0.2-lightgrey?style=for-the-badge&logo=nx&logoWidth=20&&color=1fb2a6)](http://nx.dev/)&nbsp;[![NextJs](https://img.shields.io/badge/Next.js-14.0.2-lightgrey?style=for-the-badge&logo=nextdotjs&logoWidth=20&color=1fb2a6)](https://nextjs.org/)&nbsp;[![Commitizen friendly](https://img.shields.io/badge/commitizen-friendly-brightgreen.svg?style=for-the-badge&logo=commitlint&color=1fb2a6)](http://commitizen.github.io/cz-cli/)&nbsp;![Semantic-Release](https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg?style=for-the-badge&color=1fb2a6)&nbsp;[![documented with Fumadocs](https://img.shields.io/badge/documented_with-fumadocs-success.svg?style=for-the-badge&logo=readthedocs&color=1fb2a6)](https://fumadocs.vercel.app/)&nbsp;![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/storm-software/storm-ops/cr.yml?style=for-the-badge&logo=github-actions&color=1fb2a6)
 
 <!-- prettier-ignore-start -->
 <!-- markdownlint-disable -->

package/dist/chunk-CWBVTZAO.mjs

@@ -0,0 +1,467 @@
+import {
+  pnpmCatalogUpdate
+} from "./chunk-HMJTTE4A.mjs";
+import {
+  joinPaths
+} from "./chunk-U7JFVMCK.mjs";
+
+// src/executors/npm-publish/executor.ts
+import {
+  detectPackageManager,
+  readJsonFile
+} from "@nx/devkit";
+import * as columnify from "columnify";
+import { exec, execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { relative } from "node:path";
+import { env as appendLocalEnv } from "npm-run-path";
+var LARGE_BUFFER = 1024 * 1e6;
+function processEnv(color) {
+  const env = {
+    ...process.env,
+    ...appendLocalEnv()
+  };
+  if (color) {
+    env.FORCE_COLOR = `${color}`;
+  }
+  return env;
+}
+async function npmPublishExecutorFn(options, context) {
+  const pm = detectPackageManager();
+  const isDryRun = process.env.NX_DRY_RUN === "true" || options.dryRun || false;
+  const projectConfig = context.projectsConfigurations.projects[context.projectName];
+  const packageRoot = joinPaths(
+    context.root,
+    options.packageRoot ?? projectConfig.root
+  );
+  const packageJsonPath = joinPaths(packageRoot, "package.json");
+  const packageJson = readJsonFile(packageJsonPath);
+  const packageName = packageJson.name;
+  await pnpmCatalogUpdate(packageRoot, context.root);
+  const packageTxt = packageName === context.projectName ? `package "${packageName}"` : `package "${packageName}" from project "${context.projectName}"`;
+  if (packageJson.private === true) {
+    console.warn(
+      `Skipped ${packageTxt}, because it has \`"private": true\` in ${packageJsonPath}`
+    );
+    return {
+      success: true
+    };
+  }
+  const warnFn = (message) => {
+    console.log(message);
+  };
+  const { registry, tag, registryConfigKey } = await parseRegistryOptions(
+    context.root,
+    {
+      packageRoot,
+      packageJson
+    },
+    {
+      registry: options.registry,
+      tag: options.tag
+    },
+    warnFn
+  );
+  const npmViewCommandSegments = [
+    `npm view ${packageName} versions dist-tags --json --"${registryConfigKey}=${registry}"`
+  ];
+  const npmDistTagAddCommandSegments = [
+    `npm dist-tag add ${packageName}@${packageJson.version} ${tag} --"${registryConfigKey}=${registry}"`
+  ];
+  if (!isDryRun && !options.firstRelease) {
+    const currentVersion = packageJson.version;
+    try {
+      const result = execSync(npmViewCommandSegments.join(" "), {
+        env: processEnv(true),
+        cwd: context.root,
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: false
+      });
+      const resultJson = JSON.parse(result.toString());
+      const distTags = resultJson["dist-tags"] || {};
+      if (distTags[tag] === currentVersion) {
+        console.warn(
+          `Skipped ${packageTxt} because v${currentVersion} already exists in ${registry} with tag "${tag}"`
+        );
+        return {
+          success: true
+        };
+      }
+      const versions = Array.isArray(resultJson.versions) ? resultJson.versions : [resultJson.versions];
+      if (versions.includes(currentVersion)) {
+        try {
+          if (!isDryRun) {
+            execSync(npmDistTagAddCommandSegments.join(" "), {
+              env: processEnv(true),
+              cwd: context.root,
+              stdio: "ignore",
+              windowsHide: false
+            });
+            console.log(
+              `Added the dist-tag ${tag} to v${currentVersion} for registry ${registry}.
+`
+            );
+          } else {
+            console.log(
+              `Would add the dist-tag ${tag} to v${currentVersion} for registry ${registry}, but "[dry-run]" was set.
+`
+            );
+          }
+          return {
+            success: true
+          };
+        } catch (err) {
+          try {
+            const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+            if (!(stdoutData.error?.code?.includes("E404") && stdoutData.error?.summary?.includes("no such package available")) && !(err.stderr?.toString().includes("E404") && err.stderr?.toString().includes("no such package available"))) {
+              console.error("npm dist-tag add error:");
+              if (stdoutData.error.summary) {
+                console.error(stdoutData.error.summary);
+              }
+              if (stdoutData.error.detail) {
+                console.error(stdoutData.error.detail);
+              }
+              if (context.isVerbose) {
+                console.error("npm dist-tag add stdout:");
+                console.error(JSON.stringify(stdoutData, null, 2));
+              }
+              return {
+                success: false
+              };
+            }
+          } catch (err2) {
+            console.error(
+              "Something unexpected went wrong when processing the npm dist-tag add output\n",
+              err2
+            );
+            return {
+              success: false
+            };
+          }
+        }
+      }
+    } catch (err) {
+      const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+      if (!(stdoutData.error?.code?.includes("E404") && stdoutData.error?.summary?.toLowerCase().includes("not found")) && !(err.stderr?.toString().includes("E404") && err.stderr?.toString().toLowerCase().includes("not found"))) {
+        console.error(
+          `Something unexpected went wrong when checking for existing dist-tags.
+`,
+          err
+        );
+        return {
+          success: false
+        };
+      }
+    }
+  }
+  if (options.firstRelease && context.isVerbose) {
+    console.log("Skipped npm view because --first-release was set");
+  }
+  const publishCommandSegments = [
+    pm === "bun" ? (
+      // Unlike npm, bun publish does not support a custom registryConfigKey option
+      `bun publish --cwd="${packageRoot}" --json --registry="${registry}" --tag=${tag}`
+    ) : pm === "pnpm" ? (
+      // Unlike npm, pnpm publish does not support a custom registryConfigKey option, and will error on uncommitted changes by default if --no-git-checks is not set
+      `pnpm publish "${packageRoot}" --json --registry="${registry}" --tag=${tag} --no-git-checks`
+    ) : `npm publish "${packageRoot}" --json --"${registryConfigKey}=${registry}" --tag=${tag}`
+  ];
+  if (options.otp) {
+    publishCommandSegments.push(`--otp=${options.otp}`);
+  }
+  publishCommandSegments.push(`--access=public`);
+  if (isDryRun) {
+    publishCommandSegments.push(`--dry-run`);
+  }
+  try {
+    const output = execSync(publishCommandSegments.join(" "), {
+      maxBuffer: LARGE_BUFFER,
+      env: processEnv(true),
+      cwd: context.root,
+      stdio: ["ignore", "pipe", "pipe"],
+      windowsHide: false
+    });
+    const dryRunVersionPlaceholder = "X.X.X-dry-run";
+    const publishSummaryMessage = isDryRun ? `Would publish to ${registry} with tag "${tag}", but "[dry-run]" was set` : `Published to ${registry} with tag "${tag}"`;
+    if (pm === "bun") {
+      let outputStr = output.toString();
+      if (isDryRun) {
+        outputStr = outputStr.replace(
+          new RegExp(`${packageJson.name}@${packageJson.version}`, "g"),
+          `${packageJson.name}@${dryRunVersionPlaceholder}`
+        );
+      }
+      console.log(outputStr);
+      console.log(publishSummaryMessage);
+      return {
+        success: true
+      };
+    }
+    const { beforeJsonData, jsonData, afterJsonData } = extractNpmPublishJsonData(output.toString());
+    if (!jsonData) {
+      console.error(
+        `The ${pm} publish output data could not be extracted. Please report this issue on https://github.com/nrwl/nx`
+      );
+      return {
+        success: false
+      };
+    }
+    if (isDryRun) {
+      for (const [key, val] of Object.entries(jsonData)) {
+        if (typeof val !== "string") {
+          continue;
+        }
+        jsonData[key] = val.replace(
+          new RegExp(packageJson.version, "g"),
+          dryRunVersionPlaceholder
+        );
+      }
+    }
+    if (typeof beforeJsonData === "string" && beforeJsonData.trim().length > 0) {
+      console.log(beforeJsonData);
+    }
+    logTar(jsonData);
+    if (typeof afterJsonData === "string" && afterJsonData.trim().length > 0) {
+      console.log(afterJsonData);
+    }
+    console.log(publishSummaryMessage);
+    return {
+      success: true
+    };
+  } catch (err) {
+    try {
+      if (pm === "bun") {
+        console.error(`bun publish error:`);
+        console.error(err.stderr?.toString() || "");
+        console.error(err.stdout?.toString() || "");
+        return {
+          success: false
+        };
+      }
+      const stdoutData = JSON.parse(err.stdout?.toString() || "{}");
+      console.error(`${pm} publish error:`);
+      if (stdoutData.error?.summary) {
+        console.error(stdoutData.error.summary);
+      }
+      if (stdoutData.error?.detail) {
+        console.error(stdoutData.error.detail);
+      }
+      if (context.isVerbose) {
+        console.error(`${pm} publish stdout:`);
+        console.error(JSON.stringify(stdoutData, null, 2));
+      }
+      if (!stdoutData.error) {
+        throw err;
+      }
+      return {
+        success: false
+      };
+    } catch (err2) {
+      console.error(
+        `Something unexpected went wrong when processing the ${pm} publish output
+`,
+        err2
+      );
+      return {
+        success: false
+      };
+    }
+  }
+}
+async function parseRegistryOptions(cwd, pkg, options, logWarnFn = console.warn) {
+  const npmRcPath = joinPaths(pkg.packageRoot, ".npmrc");
+  if (existsSync(npmRcPath)) {
+    const relativeNpmRcPath = relative(cwd, npmRcPath);
+    logWarnFn(
+      `
+Ignoring .npmrc file detected in the package root: ${relativeNpmRcPath}. Nested .npmrc files are not supported by npm. Only the .npmrc file at the root of the workspace will be used. To customize the registry or tag for specific packages, see https://nx.dev/recipes/nx-release/configure-custom-registries
+`
+    );
+  }
+  const scope = pkg.packageJson.name.startsWith("@") ? pkg.packageJson.name.split("/")[0] : "";
+  const registryConfigKey = scope ? `${scope}:registry` : "registry";
+  const publishConfigRegistry = pkg.packageJson.publishConfig?.[registryConfigKey];
+  if (publishConfigRegistry || pkg.packageJson.publishConfig?.registry) {
+    const relativePackageJsonPath = relative(
+      cwd,
+      joinPaths(pkg.packageRoot, "package.json")
+    );
+    if (options.registry) {
+      logWarnFn(
+        `
+Registry detected in the 'publishConfig' of the package manifest: ${relativePackageJsonPath}. This will override your registry option set in the project configuration or passed via the --registry argument, which is why configuring the registry with 'publishConfig' is not recommended. For details, see https://nx.dev/recipes/nx-release/configure-custom-registries
+`
+      );
+    } else {
+      logWarnFn(
+        `
+Registry detected in the 'publishConfig' of the package manifest: ${relativePackageJsonPath}. Configuring the registry in this way is not recommended because it prevents the registry from being overridden in project configuration or via the --registry argument. To customize the registry for specific packages, see https://nx.dev/recipes/nx-release/configure-custom-registries
+`
+      );
+    }
+  }
+  const registry = (
+    // `npm publish` will always use the publishConfig registry if it exists, even over the --registry arg
+    publishConfigRegistry || options.registry || await getNpmRegistry(cwd, scope)
+  );
+  const tag = options.tag || await getNpmTag(cwd);
+  if (!registry || !tag) {
+    throw new Error(
+      `The registry and tag options are required. Please provide them in the project configuration or via the --registry and --tag arguments.`
+    );
+  }
+  return { registry, tag, registryConfigKey };
+}
+async function getNpmRegistry(cwd, scope) {
+  let registry;
+  if (scope) {
+    registry = await getNpmConfigValue(`${scope}:registry`, cwd);
+  }
+  if (!registry) {
+    registry = await getNpmConfigValue("registry", cwd);
+  }
+  return registry;
+}
+async function getNpmTag(cwd) {
+  return getNpmConfigValue("tag", cwd);
+}
+async function getNpmConfigValue(key, cwd) {
+  try {
+    const result = await execAsync(`npm config get ${key}`, cwd);
+    return result === "undefined" ? void 0 : result;
+  } catch (_) {
+    return Promise.resolve(void 0);
+  }
+}
+async function execAsync(command, cwd) {
+  return new Promise((resolve, reject) => {
+    exec(command, { cwd, windowsHide: false }, (error, stdout, stderr) => {
+      if (error) {
+        return reject((stderr ? `${stderr}
+` : "") + error);
+      }
+      return resolve(stdout.trim());
+    });
+  });
+}
+var expectedNpmPublishJsonKeys = [
+  "id",
+  "name",
+  "version",
+  "size",
+  "filename"
+];
+function extractNpmPublishJsonData(str) {
+  const jsonMatches = str.match(/{(?:[^{}]|{[^{}]*})*}/g);
+  if (jsonMatches) {
+    for (const match of jsonMatches) {
+      if (!expectedNpmPublishJsonKeys.every((key) => str.includes(key))) {
+        continue;
+      }
+      try {
+        const parsedJson = JSON.parse(match);
+        if (!expectedNpmPublishJsonKeys.every(
+          (key) => parsedJson[key] !== void 0
+        )) {
+          continue;
+        }
+        const jsonStartIndex = str.indexOf(match);
+        return {
+          beforeJsonData: str.slice(0, jsonStartIndex),
+          jsonData: parsedJson,
+          afterJsonData: str.slice(jsonStartIndex + match.length)
+        };
+      } catch {
+      }
+    }
+  }
+  return {
+    beforeJsonData: str,
+    jsonData: null,
+    afterJsonData: ""
+  };
+}
+var formatBytes = (bytes, space = true) => {
+  let spacer = "";
+  if (space) {
+    spacer = " ";
+  }
+  if (bytes < 1e3) {
+    return `${bytes}${spacer}B`;
+  }
+  if (bytes < 1e6) {
+    return `${(bytes / 1e3).toFixed(1)}${spacer}kB`;
+  }
+  if (bytes < 1e9) {
+    return `${(bytes / 1e6).toFixed(1)}${spacer}MB`;
+  }
+  return `${(bytes / 1e9).toFixed(1)}${spacer}GB`;
+};
+var logTar = (tarball, opts = {}) => {
+  const { unicode = true } = opts;
+  console.log("");
+  console.log(
+    `${unicode ? "\u{1F4E6} " : "package:"} ${tarball.name}@${tarball.version}`
+  );
+  console.log("=== Tarball Contents ===");
+  if (tarball.files.length) {
+    console.log("");
+    const columnData = columnify(
+      tarball.files.map((f) => {
+        const bytes = formatBytes(f.size, false);
+        return /^node_modules\//.test(f.path) ? null : { path: f.path, size: `${bytes}` };
+      }).filter((f) => f),
+      {
+        include: ["size", "path"],
+        showHeaders: false
+      }
+    );
+    columnData.split("\n").forEach((line) => {
+      console.log(line);
+    });
+  }
+  if (tarball.bundled.length) {
+    console.log("=== Bundled Dependencies ===");
+    tarball.bundled.forEach((name) => console.log("", name));
+  }
+  console.log("=== Tarball Details ===");
+  console.log(
+    columnify(
+      [
+        { name: "name:", value: tarball.name },
+        { name: "version:", value: tarball.version },
+        tarball.filename && { name: "filename:", value: tarball.filename },
+        { name: "package size:", value: formatBytes(tarball.size) },
+        { name: "unpacked size:", value: formatBytes(tarball.unpackedSize) },
+        { name: "shasum:", value: tarball.shasum },
+        {
+          name: "integrity:",
+          value: tarball.integrity.toString().slice(0, 20) + "[...]" + tarball.integrity.toString().slice(80)
+        },
+        tarball.bundled.length && {
+          name: "bundled deps:",
+          value: tarball.bundled.length
+        },
+        tarball.bundled.length && {
+          name: "bundled files:",
+          value: tarball.entryCount - tarball.files.length
+        },
+        tarball.bundled.length && {
+          name: "own files:",
+          value: tarball.files.length
+        },
+        { name: "total files:", value: tarball.entryCount }
+      ].filter((x) => x),
+      {
+        include: ["name", "value"],
+        showHeaders: false
+      }
+    )
+  );
+  console.log("", "");
+};
+
+export {
+  LARGE_BUFFER,
+  npmPublishExecutorFn
+};