semver 7.8.5

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: verify pkg:npm/semver@7.8.5
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/semver@7.8.5
Constraints:
  - executionContext: node
Required runtime conditions:
  - ecosystem: npm
  - language: javascript
  - moduleSystem: cjs
  - packageManager: npm@10.9.8
  - runtime: node@22.23.2

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:5bcfe828aa6bcf409982cdb40c7a5675e554e093332905b93e8d935bc5a195f0","constraints":{"executionContext":"node"},"contract":["semver.inc increments major, minor, and patch version numbers according to the specified release type","semver.inc increments versions with prerelease identifiers for prepatch, preminor, and premajor release types","semver.inc increments existing prerelease versions or appends a new identifier","semver.inc returns null when given an invalid version string or invalid release type","semver.diff returns the difference type between two versions as major, minor, patch, or prerelease variants","semver.diff returns null when comparing two identical versions","semver.diff throws TypeError when provided with an invalid version string"],"goal":"verify pkg:npm/semver@7.8.5","kind":"HOW","packages":["pkg:npm/semver@7.8.5"],"schemaVersion":1,"symbols":["semver.diff","semver.inc"]},"contractCommand":["node","test/contract.mjs"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","executionContext":"node","language":"javascript","libc":"glibc","libcVersion":"2.39","moduleSystem":"cjs","os":"linux","osVersionBucket":"24","packageManager":"npm","packageManagerVersion":"10.9.8","runtime":"node","runtimeVersion":"22.23.2","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/semver@7.8.5"],"schemaVersion":1,"subject":"pkg:npm/semver@7.8.5","verifierAdapter":"node-typescript@1"}

{
  "name": "sample-semver",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-semver",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "semver": "7.8.5"
      }
    },
    "node_modules/semver": {
      "version": "7.8.5",
      "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.5.tgz",
      "integrity": "sha512-Y7/KDsb8LjooZpwaqGyulO6DQlksgCncchHGk+sZIY4SBvUocMBEFH5Ur1fI4dV+Jvl0w6cjvucaIi40puRioA==",
      "license": "ISC",
      "bin": {
        "semver": "bin/semver.js"
      },
      "engines": {
        "node": ">=10"
      }
    }
  }
}

{
  "name": "sample-semver",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification of semver version increment and diffing",
  "main": "src/index.js",
  "license": "MIT-0",
  "dependencies": {
    "semver": "7.8.5"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify pkg:npm/semver@7.8.5",
  "kind": "HOW",
  "packages": [
    "pkg:npm/semver@7.8.5"
  ],
  "constraints": {
    "executionContext": "node"
  },
  "runtimeConditions": {
    "ecosystem": "npm",
    "language": "javascript",
    "moduleSystem": "cjs",
    "packageManager": "npm@10.9.8",
    "runtime": "node@22.23.2"
  }
}

const semver = require('semver');

/**
 * Increments a version string by the specified release type.
 *
 * @param {string} version - The version string to increment.
 * @param {string} release - Release type (e.g. 'major', 'minor', 'patch', 'premajor', 'preminor', 'prepatch', 'prerelease').
 * @param {object|string} [optionsOrIdentifier] - Options or prerelease identifier.
 * @param {string} [identifier] - Prerelease identifier if options was provided as an object.
 * @returns {string|null} The incremented version string, or null if invalid.
 */
function incrementVersion(version, release, optionsOrIdentifier, identifier) {
  return semver.inc(version, release, optionsOrIdentifier, identifier);
}

/**
 * Determines the difference type between two version strings.
 *
 * @param {string} v1 - First version string.
 * @param {string} v2 - Second version string.
 * @param {object} [options] - Comparison options.
 * @returns {string|null} Release type difference ('major', 'minor', 'patch', etc.), or null if equal.
 */
function diffVersions(v1, v2, options) {
  return semver.diff(v1, v2, options);
}

module.exports = {
  semver,
  incrementVersion,
  diffVersions,
  inc: semver.inc,
  diff: semver.diff
};

import assert from 'node:assert/strict';
import { createRequire } from 'node:module';

const require = createRequire(import.meta.url);
const { semver, incrementVersion, diffVersions, inc, diff } = require('../src/index.js');

// 1. Export verification
assert.equal(typeof semver, 'object', 'semver module object must be exported');
assert.equal(typeof incrementVersion, 'function', 'incrementVersion helper must be exported');
assert.equal(typeof diffVersions, 'function', 'diffVersions helper must be exported');
assert.equal(typeof inc, 'function', 'inc method must be exported');
assert.equal(typeof diff, 'function', 'diff method must be exported');

// 2. semver.inc increments major, minor, and patch version numbers according to the specified release type
{
  assert.equal(inc('1.2.3', 'major'), '2.0.0');
  assert.equal(incrementVersion('1.2.3', 'minor'), '1.3.0');
  assert.equal(inc('1.2.3', 'patch'), '1.2.4');
  assert.equal(inc('0.1.0', 'major'), '1.0.0');
  assert.equal(inc('0.1.0', 'minor'), '0.2.0');
  assert.equal(inc('0.1.0', 'patch'), '0.1.1');
}

// 3. semver.inc increments versions with prerelease identifiers for prepatch, preminor, and premajor release types
{
  assert.equal(inc('1.2.3', 'premajor', 'beta'), '2.0.0-beta.0');
  assert.equal(inc('1.2.3', 'preminor', 'rc'), '1.3.0-rc.0');
  assert.equal(incrementVersion('1.2.3', 'prepatch', 'alpha'), '1.2.4-alpha.0');
  assert.equal(inc('1.0.0', 'premajor'), '2.0.0-0');
  assert.equal(inc('1.0.0', 'preminor'), '1.1.0-0');
  assert.equal(inc('1.0.0', 'prepatch'), '1.0.1-0');
}

// 4. semver.inc increments existing prerelease versions or appends a new identifier
{
  assert.equal(inc('1.2.3-alpha.0', 'prerelease'), '1.2.3-alpha.1');
  assert.equal(inc('1.2.3-alpha.1', 'prerelease'), '1.2.3-alpha.2');
  assert.equal(inc('1.2.3-alpha.0', 'prerelease', 'beta'), '1.2.3-beta.0');
  assert.equal(incrementVersion('1.2.3', 'prerelease', 'rc'), '1.2.4-rc.0');
}

// 5. semver.inc returns null when given an invalid version string or invalid release type
{
  assert.equal(inc('invalid.version', 'patch'), null);
  assert.equal(inc('1.2.3', 'unknown-release-type'), null);
  assert.equal(incrementVersion(null, 'major'), null);
  assert.equal(incrementVersion(undefined, 'minor'), null);
}

// 6. semver.diff returns the difference type between two versions as major, minor, patch, or prerelease variants
{
  assert.equal(diff('1.2.3', '2.0.0'), 'major');
  assert.equal(diff('1.2.3', '1.3.0'), 'minor');
  assert.equal(diffVersions('1.2.3', '1.2.4'), 'patch');
  assert.equal(diff('1.2.3', '2.0.0-alpha.0'), 'premajor');
  assert.equal(diff('1.2.3', '1.3.0-alpha.0'), 'preminor');
  assert.equal(diff('1.2.3', '1.2.4-alpha.0'), 'prepatch');
  assert.equal(diffVersions('1.2.3-alpha.0', '1.2.3-alpha.1'), 'prerelease');
  assert.equal(diff('1.2.3-alpha.0', '1.2.3-beta.0'), 'prerelease');
}

// 7. semver.diff returns null when comparing two identical versions
{
  assert.equal(diff('1.2.3', '1.2.3'), null);
  assert.equal(diffVersions('2.0.0-alpha.1', '2.0.0-alpha.1'), null);
}

// 8. semver.diff throws TypeError when provided with an invalid version string
{
  assert.throws(
    () => {
      diff('not-a-version', '1.2.3');
    },
    {
      name: 'TypeError'
    }
  );
  assert.throws(
    () => {
      diffVersions('1.2.3', 'invalid');
    },
    {
      name: 'TypeError'
    }
  );
}

console.log('Contract assertions passed.');