Skip to content
HALOWERK

Codewerk

semver next

Parses commits per Conventional Commits 1.0.0 (type(scope)!: description, BREAKING CHANGE / BREAKING-CHANGE footers) and applies the specification's SemVer mapping: breaking change → major, feat → minor, fix → patch; other types do not release unless configured. Pre-releases follow node-semver 7.8: an existing pre-release line is continued when it already covers the bump (1.2.0-rc.1 + fix → 1.2.0-rc.2), otherwise a new pre-release starts. Optional 0.x rule (breaking → minor while major is.

POST https://code.halowerk.com/v1/semver-next

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
current_versionstringYesCurrent released version, e.g. 1.4.2 or v1.4.2 (prefix is kept).
commitsarrayYesCommit messages since the last release (strings or {message, hash}).
prereleasestringNoPre-release identifier such as rc, beta or alpha.
keep_major_zerobooleanNoWhile major is 0, bump minor for breaking changes instead of releasing 1.0.0.
minor_typesarrayNoTypes that trigger a minor release.
patch_typesarrayNoTypes that trigger a patch release (the specification only names fix).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "current_version",
    "commits"
  ],
  "properties": {
    "current_version": {
      "type": "string",
      "minLength": 5,
      "maxLength": 80,
      "description": "Current released version, e.g. 1.4.2 or v1.4.2 (prefix is kept)."
    },
    "commits": {
      "type": "array",
      "minItems": 1,
      "maxItems": 1000,
      "items": {
        "anyOf": [
          {
            "type": "string",
            "minLength": 1,
            "maxLength": 20000
          },
          {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "message"
            ],
            "properties": {
              "message": {
                "type": "string",
                "minLength": 1,
                "maxLength": 20000,
                "description": "Full commit message (header, body, footers)."
              },
              "hash": {
                "type": "string",
                "pattern": "^[0-9a-fA-F]{7,64}$",
                "description": "Commit hash (optional, used for links)."
              }
            }
          }
        ]
      },
      "description": "Commit messages since the last release (strings or {message, hash})."
    },
    "prerelease": {
      "type": "string",
      "pattern": "^[0-9A-Za-z-]{1,20}$",
      "description": "Pre-release identifier such as rc, beta or alpha."
    },
    "keep_major_zero": {
      "type": "boolean",
      "default": false,
      "description": "While major is 0, bump minor for breaking changes instead of releasing 1.0.0."
    },
    "minor_types": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "pattern": "^[a-z][a-z0-9-]{0,30}$"
      },
      "default": [
        "feat"
      ],
      "description": "Types that trigger a minor release."
    },
    "patch_types": {
      "type": "array",
      "maxItems": 10,
      "items": {
        "type": "string",
        "pattern": "^[a-z][a-z0-9-]{0,30}$"
      },
      "default": [
        "fix"
      ],
      "description": "Types that trigger a patch release (the specification only names fix)."
    }
  }
}

Open original schema

Published input example

{
  "current_version": "1.4.2",
  "commits": [
    "feat(ui): dark mode",
    "fix: typo in footer",
    "docs: update readme"
  ]
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →