feat: add build info

Author: josephearl

Diff for: README.md

@@ -24,6 +24,7 @@ Otherwise the version and its components are avaialbe through action outputs.
     echo "v${{ steps.semver.outputs.minor }}"
     echo "v${{ steps.semver.outputs.patch }}"
     echo "v${{ steps.semver.outputs.extra }}"
+    echo "v${{ steps.semver.outputs.build }}"
 ```
 
 ## Inputs
@@ -48,11 +49,12 @@ The following outputs are available through `steps.<id>.outputs` when the action
 
 | Name | Type | Description | Example |
 | ---- | --- | ------------ | ------- |
-| `version` | `string` | The full version wihout prefixes | `2.13.34-dev` |
+| `version` | `string` | The full version wihout prefixes | `2.13.34-dev+001` |
 | `major` | `string` | The major version number | `2` |
 | `minor` | `string` | The minor version number | `13` |
 | `patch` | `string` | The patch version number | `34` |
 | `extra` | `string` | The prerelease version or extra | `dev` |
+| `build` | `string` | The build metadata | `001` |
 
 > [!TIP]
 > The version is coerced in to a semantic version as per the [resolution strategy](#resolution-strategy), therefore all outputs will be present assuming the action succeeds.

Diff for: src/core/action.test.ts

@@ -19,7 +19,7 @@ describe('action()', (): void => {
     expect(input).toBeCalledTimes(1);
     expect(input).toHaveBeenNthCalledWith<[string, ActionInputFunctionOptions]>(1, 'version', { required: true });
 
-    expect(output).toBeCalledTimes(5);
+    expect(output).toBeCalledTimes(6);
     expect(output).toHaveBeenNthCalledWith<[string, string]>(1, 'version', '1.2.3');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(2, 'major', '1');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(3, 'minor', '2');
@@ -34,7 +34,7 @@ describe('action()', (): void => {
     const output = fn<ActionOutputFunction>();
     const fail = fn<ActionFailFunction>();
 
-    input.mockReturnValueOnce('10.23.4');
+    input.mockReturnValueOnce('v10.23.4');
 
     await action({
       input,
@@ -45,7 +45,7 @@ describe('action()', (): void => {
     expect(input).toBeCalledTimes(1);
     expect(input).toHaveBeenNthCalledWith<[string, ActionInputFunctionOptions]>(1, 'version', { required: true });
 
-    expect(output).toBeCalledTimes(5);
+    expect(output).toBeCalledTimes(6);
     expect(output).toHaveBeenNthCalledWith<[string, string]>(1, 'version', '10.23.4');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(2, 'major', '10');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(3, 'minor', '23');
@@ -60,7 +60,7 @@ describe('action()', (): void => {
     const output = fn<ActionOutputFunction>();
     const fail = fn<ActionFailFunction>();
 
-    input.mockReturnValueOnce('2.3-alpha.2');
+    input.mockReturnValueOnce('2.3-alpha.2+001');
 
     await action({
       input,
@@ -71,12 +71,13 @@ describe('action()', (): void => {
     expect(input).toBeCalledTimes(1);
     expect(input).toHaveBeenNthCalledWith<[string, ActionInputFunctionOptions]>(1, 'version', { required: true });
 
-    expect(output).toBeCalledTimes(5);
+    expect(output).toBeCalledTimes(6);
     expect(output).toHaveBeenNthCalledWith<[string, string]>(1, 'version', '2.3.0-alpha.2');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(2, 'major', '2');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(3, 'minor', '3');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(4, 'patch', '0');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(5, 'extra', 'alpha.2');
+    expect(output).toHaveBeenNthCalledWith<[string, string]>(6, 'build', '001');
 
     expect(fail).toBeCalledTimes(0);
   });
@@ -97,12 +98,13 @@ describe('action()', (): void => {
     expect(input).toBeCalledTimes(1);
     expect(input).toHaveBeenNthCalledWith<[string, ActionInputFunctionOptions]>(1, 'version', { required: true });
 
-    expect(output).toBeCalledTimes(5);
+    expect(output).toBeCalledTimes(6);
     expect(output).toHaveBeenNthCalledWith<[string, string]>(1, 'version', '4.36.14');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(2, 'major', '4');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(3, 'minor', '36');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(4, 'patch', '14');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(5, 'extra', '');
+    expect(output).toHaveBeenNthCalledWith<[string, string]>(6, 'build', '');
 
     expect(fail).toBeCalledTimes(0);
   });
@@ -123,12 +125,13 @@ describe('action()', (): void => {
     expect(input).toBeCalledTimes(1);
     expect(input).toHaveBeenNthCalledWith<[string, ActionInputFunctionOptions]>(1, 'version', { required: true });
 
-    expect(output).toBeCalledTimes(5);
+    expect(output).toBeCalledTimes(6);
     expect(output).toHaveBeenNthCalledWith<[string, string]>(1, 'version', '5.31.12-beta.1');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(2, 'major', '5');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(3, 'minor', '31');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(4, 'patch', '12');
     expect(output).toHaveBeenNthCalledWith<[string, string]>(5, 'extra', 'beta.1');
+    expect(output).toHaveBeenNthCalledWith<[string, string]>(6, 'build', '');
 
     expect(fail).toBeCalledTimes(0);
   });

Diff for: src/core/action.ts

@@ -55,6 +55,7 @@ export const action = async (action: ActionDependencies): Promise<void> => {
     action.output('minor', validated.part.minor);
     action.output('patch', validated.part.patch);
     action.output('extra', validated.part.extra);
+    action.output('build', validated.part.build);
   } catch (error: unknown) {
     action.fail(`An unexpected error occured: ${error}`);
   }