semver 6.3.1: inc

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 semver.inc in pkg:npm/semver@6.3.1
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/semver@6.3.1
Demonstrate these symbols/APIs:
  - semver.inc

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:0b009fb926be7945ff8e844cfc33f5801d2cbc19596d5fd2e0b68128ccd437c4","contract":["assert semver.inc correctly increments major, minor, and patch release versions","assert semver.inc creates premajor, preminor, and prepatch versions with custom prerelease identifiers","assert semver.inc increments existing prerelease numbers and replaces prerelease tags when specified","assert semver.inc increments release version to prerelease with default 0 suffix","assert semver.inc returns null for invalid semver strings and invalid release types","assert semver.inc supports loose parsing mode via boolean flag or options object to handle leading prefixes and whitespace"],"goal":"verify semver.inc in pkg:npm/semver@6.3.1","kind":"HOW","packages":["pkg:npm/semver@6.3.1"],"schemaVersion":1,"symbols":["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@6.3.1"],"schemaVersion":1,"subject":"pkg:npm/semver@6.3.1","symbols":["semver.inc"],"verifierAdapter":"node-typescript@1"}

const semver = require('semver');

/**
 * Increment a version string by the specified release type.
 *
 * @param {string} version - The semver version string to increment.
 * @param {string} releaseType - Release type: 'major', 'premajor', 'minor', 'preminor', 'patch', 'prepatch', 'prerelease'.
 * @param {boolean|object} [options] - Options or loose flag.
 * @param {string} [identifier] - Prerelease identifier (e.g. 'alpha', 'beta', 'rc').
 * @returns {string|null} Incremented semver string, or null if version/releaseType is invalid.
 */
function incrementVersion(version, releaseType, options, identifier) {
  return semver.inc(version, releaseType, options, identifier);
}

/**
 * Increment to a prerelease version with a specific identifier tag.
 *
 * @param {string} version - The semver version string.
 * @param {string} [identifier] - Prerelease tag (e.g. 'alpha', 'beta', 'rc').
 * @param {boolean|object} [options] - Loose options.
 * @returns {string|null} Incremented prerelease semver string.
 */
function incrementPrerelease(version, identifier, options) {
  return semver.inc(version, 'prerelease', options, identifier);
}

/**
 * Increment major version.
 *
 * @param {string} version
 * @param {boolean|object} [options]
 * @returns {string|null}
 */
function incrementMajor(version, options) {
  return semver.inc(version, 'major', options);
}

/**
 * Increment minor version.
 *
 * @param {string} version
 * @param {boolean|object} [options]
 * @returns {string|null}
 */
function incrementMinor(version, options) {
  return semver.inc(version, 'minor', options);
}

/**
 * Increment patch version.
 *
 * @param {string} version
 * @param {boolean|object} [options]
 * @returns {string|null}
 */
function incrementPatch(version, options) {
  return semver.inc(version, 'patch', options);
}

module.exports = {
  incrementVersion,
  incrementPrerelease,
  incrementMajor,
  incrementMinor,
  incrementPatch,
  semver,
};

{
  "name": "sample-semver-inc",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-semver-inc",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "semver": "6.3.1"
      }
    },
    "node_modules/semver": {
      "version": "6.3.1",
      "resolved": "https://registry.npmjs.org/semver/-/semver-6.3.1.tgz",
      "integrity": "sha512-BR7VvDCVHO+q2xBEWskxS6DJE1qRnb7DxzUrogb71CWoSficBxYsiAGd+Kl0mmq/MprG9yArRkyrQxTO6XjMzA==",
      "license": "ISC",
      "bin": {
        "semver": "bin/semver.js"
      }
    }
  }
}

{
  "name": "sample-semver-inc",
  "version": "1.0.0",
  "description": "Minimal clean-room sample verifying semver.inc version increment operations",
  "main": "index.js",
  "license": "MIT-0",
  "dependencies": {
    "semver": "6.3.1"
  }
}

{
  "schemaVersion": 1,
  "goal": "verify semver.inc in pkg:npm/semver@6.3.1",
  "kind": "HOW",
  "packages": [
    "pkg:npm/semver@6.3.1"
  ],
  "symbols": [
    "semver.inc"
  ]
}

import assert from 'node:assert';
import semver from 'semver';
import {
  incrementVersion,
  incrementPrerelease,
  incrementMajor,
  incrementMinor,
  incrementPatch,
} from '../index.js';

// 1. Major, minor, and patch increments
assert.strictEqual(incrementMajor('1.2.3'), '2.0.0', 'Major increment must advance major number and reset minor/patch');
assert.strictEqual(incrementMinor('1.2.3'), '1.3.0', 'Minor increment must advance minor number and reset patch');
assert.strictEqual(incrementPatch('1.2.3'), '1.2.4', 'Patch increment must advance patch number');
assert.strictEqual(semver.inc('1.2.3', 'major'), '2.0.0');
assert.strictEqual(semver.inc('1.2.3', 'minor'), '1.3.0');
assert.strictEqual(semver.inc('1.2.3', 'patch'), '1.2.4');

// 2. Premajor, preminor, and prepatch with custom identifiers
assert.strictEqual(semver.inc('1.2.3', 'premajor', 'alpha'), '2.0.0-alpha.0', 'Premajor increment with alpha must yield 2.0.0-alpha.0');
assert.strictEqual(semver.inc('1.2.3', 'preminor', 'beta'), '1.3.0-beta.0', 'Preminor increment with beta must yield 1.3.0-beta.0');
assert.strictEqual(semver.inc('1.2.3', 'prepatch', 'rc'), '1.2.4-rc.0', 'Prepatch increment with rc must yield 1.2.4-rc.0');

// 3. Prerelease increment with existing tag and replacement tag
assert.strictEqual(incrementPrerelease('1.2.3-alpha.0'), '1.2.3-alpha.1', 'Prerelease increment must bump numeric segment');
assert.strictEqual(incrementPrerelease('1.2.3-alpha.1', 'beta'), '1.2.3-beta.0', 'Prerelease increment with new identifier must replace tag and reset number');
assert.strictEqual(semver.inc('1.2.3-beta.4', 'prerelease'), '1.2.3-beta.5');

// 4. Prerelease increment on a release version
assert.strictEqual(incrementPrerelease('1.2.3'), '1.2.4-0', 'Prerelease on non-prerelease version must increment patch with -0 suffix');
assert.strictEqual(semver.inc('1.2.3', 'prerelease', 'rc'), '1.2.4-rc.0', 'Prerelease with identifier on non-prerelease version must increment patch with -rc.0');

// 5. Invalid semver strings and invalid release types return null
assert.strictEqual(incrementVersion('not-a-valid-version', 'patch'), null, 'Invalid semver string must return null');
assert.strictEqual(incrementVersion('1.2.3', 'invalid-type'), null, 'Invalid release type must return null');
assert.strictEqual(semver.inc('', 'major'), null, 'Empty version string must return null');

// 6. Loose parsing mode handling prefixes and whitespace
assert.strictEqual(incrementVersion(' =v1.2.3 ', 'patch', true), '1.2.4', 'Loose mode with boolean true must handle prefix and whitespace');
assert.strictEqual(incrementVersion(' =v1.2.3 ', 'patch', { loose: true }), '1.2.4', 'Loose mode with options object must handle prefix and whitespace');
assert.strictEqual(incrementVersion(' =v1.2.3 ', 'patch', false), null, 'Strict mode must reject prefix and whitespace and return null');

console.log('All semver.inc contract assertions passed.');