wyvrnpm 2.10.2 → 2.12.2

package/src/commands/version.js

@@ -0,0 +1,187 @@
+'use strict';
+
+const path = require('path');
+
+const { readManifest, writeManifest } = require('../manifest');
+const log                             = require('../logger');
+
+/** Strict 4-part wyvrnpm version: `x.y.z.b`, all non-negative integers, no leading zeros. */
+const VERSION_RE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/;
+
+/**
+ * Parse a 4-part version string into `[major, minor, patch, build]`.
+ * Throws with a clear message when the string fails the wyvrnpm format.
+ *
+ * @param {string} v
+ * @returns {[number, number, number, number]}
+ */
+function parseVersion(v) {
+  if (typeof v !== 'string' || v.length === 0) {
+    throw new Error('version is empty');
+  }
+  const m = VERSION_RE.exec(v);
+  if (!m) {
+    throw new Error(
+      `"${v}" is not a valid wyvrnpm version. ` +
+      'Expected 4-part x.y.z.b with non-negative integers (e.g. 1.2.3.4).',
+    );
+  }
+  return [Number(m[1]), Number(m[2]), Number(m[3]), Number(m[4])];
+}
+
+const COMPONENT_INDEX = { major: 0, minor: 1, patch: 2, build: 3 };
+
+function isNonNegInt(n) {
+  return Number.isInteger(n) && n >= 0;
+}
+
+/**
+ * `wyvrnpm version [<new-version>]` — read, set, or partially update the
+ * top-level `version` field in wyvrn.json. Designed for CI/CD (build-number
+ * injection + tag-the-build readback).
+ *
+ *   wyvrnpm version                      → print the current version
+ *   wyvrnpm version 1.2.3.4              → set verbatim
+ *   wyvrnpm version --build 99           → only the 4th component
+ *   wyvrnpm version --minor 3 --build 0  → multiple components, others left alone
+ *
+ * Positional and component flags are mutually exclusive — pick one mode.
+ * Bare invocation is read-only (never writes, never warns about an unset
+ * version on disk — it prints `(unset)` to stderr and exits 1 in that
+ * case so scripts notice). CI scripts use --format json to capture the
+ * `{ previous, version }` payload on stdout.
+ *
+ * @param {object} argv
+ */
+function versionCmd(argv) {
+  const manifestPath = path.resolve(argv.manifest);
+  const jsonOut = argv.format === 'json';
+  if (jsonOut) log.setJsonMode(true);
+
+  const positional = argv.newVersion;
+
+  // Component flags arrive on argv as `argv.major` / `argv.minor` / etc.
+  // because yargs lowercases option names. Keep insertion order so error
+  // messages list flags in the same order as the CLI surface.
+  const partial = {};
+  for (const key of Object.keys(COMPONENT_INDEX)) {
+    if (argv[key] !== undefined) partial[key] = argv[key];
+  }
+  const partialKeys = Object.keys(partial);
+
+  if (positional && partialKeys.length > 0) {
+    log.error(
+      'cannot combine a positional version with --major/--minor/--patch/--build. ' +
+      'Use one or the other.',
+    );
+    process.exit(1);
+  }
+
+  // Read-only mode: no positional + no component flags. Prints the current
+  // version and returns without touching disk. Matches `npm version` behaviour
+  // when called bare.
+  const readOnly = !positional && partialKeys.length === 0;
+
+  let manifest;
+  try {
+    manifest = readManifest(manifestPath);
+  } catch (err) {
+    log.error(err.message);
+    process.exit(1);
+  }
+
+  const previous =
+    typeof manifest.version === 'string' && manifest.version.length > 0
+      ? manifest.version
+      : null;
+
+  if (readOnly) {
+    const wyvrnpmVersion = require('../../package.json').version;
+    if (jsonOut) {
+      process.stdout.write(JSON.stringify({
+        command: 'version',
+        wyvrnpmVersion,
+        path:     manifestPath,
+        version:  previous,
+        written:  false,
+      }) + '\n');
+    } else if (previous) {
+      // Bare stdout for `VER=$(wyvrnpm version)` — no `[wyvrn]` prefix here.
+      process.stdout.write(previous + '\n');
+    } else {
+      log.error(`no \`version\` field in ${manifestPath}`);
+      process.exit(1);
+    }
+    return;
+  }
+
+  let newVersion;
+  if (positional) {
+    try {
+      parseVersion(positional);
+    } catch (err) {
+      log.error(err.message);
+      process.exit(1);
+    }
+    newVersion = positional;
+  } else {
+    let parts;
+    try {
+      parts = parseVersion(previous ?? '');
+    } catch (err) {
+      log.error(
+        `cannot tweak components — current manifest version is invalid or missing: ${err.message}\n` +
+        '  Set a full version first: wyvrnpm version <x.y.z.b>',
+      );
+      process.exit(1);
+    }
+    for (const key of partialKeys) {
+      const n = partial[key];
+      if (!isNonNegInt(n)) {
+        log.error(`--${key} must be a non-negative integer (got ${JSON.stringify(n)})`);
+        process.exit(1);
+      }
+      parts[COMPONENT_INDEX[key]] = n;
+    }
+    newVersion = parts.join('.');
+  }
+
+  const wyvrnpmVersion = require('../../package.json').version;
+
+  if (argv.dryRun) {
+    if (jsonOut) {
+      process.stdout.write(JSON.stringify({
+        command: 'version',
+        wyvrnpmVersion,
+        path:     manifestPath,
+        previous,
+        version:  newVersion,
+        dryRun:   true,
+        written:  false,
+      }) + '\n');
+    } else {
+      log.info(`would set version: ${previous ?? '(unset)'} → ${newVersion} (dry-run)`);
+    }
+    return;
+  }
+
+  manifest.version = newVersion;
+  writeManifest(manifestPath, manifest);
+
+  if (jsonOut) {
+    process.stdout.write(JSON.stringify({
+      command: 'version',
+      wyvrnpmVersion,
+      path:     manifestPath,
+      previous,
+      version:  newVersion,
+      dryRun:   false,
+      written:  true,
+    }) + '\n');
+  } else {
+    log.success(`${manifestPath}: ${previous ?? '(unset)'} → ${newVersion}`);
+  }
+}
+
+module.exports = versionCmd;
+module.exports.parseVersion = parseVersion;