Docs: announce random serial number in README (#598)

Signed-off-by: Jan Kowalleck <[email protected]>

Author: jkowalleck

HISTORY.md

@@ -4,6 +4,11 @@ All notable changes to this project will be documented in this file.
 
 ## unreleased
 
+* Docs
+  * Announce and annotate the generator for BOM's SerialNumber ([#588] via [#598])
+  
+[#598]: https://github.com/CycloneDX/cyclonedx-javascript-library/pull/598
+
 ## 1.13.0 - 2023-03-28
 
 * Fixed
@@ -14,7 +19,8 @@ All notable changes to this project will be documented in this file.
     Also, the setter no longer throws exceptions, since no string format is illegal.  
     This is considered a non-breaking behavior change, because the corresponding normalizers assure valid data results.
 * Added
-  * Bom serialNumber generator: `Utils.BomUtility.randomSerialNumber()` ([#588] via [#597])
+  * Published generator for BOM's SerialNumber: `Utils.BomUtility.randomSerialNumber()` ([#588] via [#597])  
+    The code was donated from [cyclonedx-node-npm](https://github.com/CycloneDX/cyclonedx-node-npm/).
 * Deprecation
   * Type alias `Types.UrnUuid = string` became deprecated (via [#597])  
     Use type `string` instead.

README.md

@@ -72,6 +72,8 @@ written in _TypeScript_ and compiled for the target.
     * `Reference`, `ReferenceRepository`
     * `Source`
     * `Vulnerability`, `VulnerabilityRepository`
+* Utilities for the following use cases:
+  * Generate valid random SerialNumbers for `Bom.serialNumber`
 * Factories for the following use cases:
   * Create data models from any license descriptor string
   * Create `PackageURL` from `Component` data models
@@ -85,7 +87,7 @@ written in _TypeScript_ and compiled for the target.
 * Normalizers that convert data models to JSON structures
 * Normalizers that convert data models to XML structures
 * Universal serializer that converts `Bom` data models to JSON string
-* Serializer that converts `Bom` data models to XML string:
+* Specific  Serializer that converts `Bom` data models to XML string:
   * Specific to _WebBrowsers_: implementation utilizes browser-specific document generators and printers.
   * Specific to _Node.js_: implementation plugs/requires/utilizes one of the following _optional_ libraries
     * [xmlbuilder2](https://www.npmjs.com/package/xmlbuilder2)

src/utils/bomUtility.ts

@@ -16,6 +16,12 @@ limitations under the License.
 SPDX-License-Identifier: Apache-2.0
 Copyright (c) OWASP Foundation. All Rights Reserved.
 */
+
+/**
+ * Generate valid random SerialNumbers for {@link Models.Bom.serialNumber | Models.Bom.serialNumber}.
+ *
+ * @since 1.13.0
+ */
 export function randomSerialNumber (): string {
   const b = [
     Math.round(Math.random() * 0xFFFF),