Core functionality of CycloneDX for JavaScript (Node.js or WebBrowsers), written in TypeScript and compiled for the target.

• Provide a general purpose JavaScript-implementation of CycloneDX for Node.js and WebBrowsers.
• Provide typing for said implementation, so developers and dev-tools can rely on it.
• Provide data models to work with CycloneDX.
• Provide a JSON- and an XML-normalizer, that...
  • supports all shipped data models.
  • respects any injected CycloneDX Specification and generates valid output according to it.
  • can be configured to generate reproducible/deterministic output.
  • can prepare data structures for JSON- and XML-serialization.
• Serialization:
  • Provide a universal JSON-serializer for all target environments.
  • Provide an XML-serializer for all target environments.
  • Support the downstream implementation of custom XML-serializers tailored to specific environments
    by providing an abstract base class that takes care of normalization and BomRef-discrimination.
    This is done, because there is no universal XML support in JavaScript.
• Deserialization:
  • Provide a JSON-deserializer for all target environments.

• Enums for the following use cases:
  • AttachmentEncoding
  • ComponentScope
  • ComponentType
  • ExternalReferenceType
  • HashAlgorithm
  • Vulnerability related:
    Release stage is “beta”. These namespace and enums have been released to third-party developers experimentally for the purpose of collecting feedback. These enums should not be used in production, because their contracts may change without notice.
    • AffectStatus
    • AnalysisJustification
    • AnalysisResponse
    • AnalysisState
    • RatingMethod
    • Severity
• Data models for the following use cases:
  • Attachment
  • Bom
  • BomRef, BomRefRepository
  • Component, ComponentRepository
  • ExternalReference, ExternalReferenceRepository
  • Hash, HashContent, HashDictionary
  • LicenseExpression, NamedLicense, SpdxLicense, LicenseRepository
  • Metadata
  • OrganizationalContact, OrganizationalContactRepository
  • OrganizationalEntity, OrganizationalEntityRepository
  • Property, PropertyRepository
  • SWID
  • Tool, ToolRepository
  • Vulnerability related:
    Release stage is “beta”. These namespace and models have been released to third-party developers experimentally for the purpose of collecting feedback. These models should not be used in production, because their contracts may change without notice.
    Attention: These models are not yet supported by serializers nor normalizers.
    • Advisory, AdvisoryRepository
    • Affect, AffectRepository, AffectedSingleVersion, AffectedVersionRange, AffectedVersionRepository
    • Analysis
    • Credits
    • Rating, RatingRepository
    • 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
  • Specific to Node.js: create data models from PackageJson-like data structures and derived data
• Builders for the following use cases:
  • Specific to Node.js: create deep data models Tool or Component from PackageJson-like data structures
• Implementation of the CycloneDX Specification for the following versions:
  • 1.4
  • 1.3
  • 1.2
• Normalizers that convert data models to JSON structures
• Denormalizers that convert JSON structures to data models
• Normalizers that convert data models to XML structures
• Universal serializer that converts Bom data models to JSON string
• Deserializer that converts JSON string to Bom data models
• 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
    • ... to be continued ... (pull requests are welcome)

This package and the build results are available for npm, pnpm and yarn:

npm i -S @cyclonedx/cyclonedx-library
pnpm add @cyclonedx/cyclonedx-library
yarn add @cyclonedx/cyclonedx-library

You can install the package from source, which will build automatically on installation:

npm i -S github:CycloneDX/cyclonedx-javascript-library
pnpm add github:CycloneDX/cyclonedx-javascript-library
yarn add @cyclonedx/cyclonedx-library@github:CycloneDX/cyclonedx-javascript-library # only with yarn-2

See extended examples.

const CDX = require('@cyclonedx/cyclonedx-library')

const bom = new CDX.Models.Bom()
bom.metadata.component = new CDX.Models.Component(
  CDX.Enums.ComponentType.Application,
  'MyProject'
)
const componentA = new CDX.Models.Component(
  CDX.Enums.ComponentType.Library,
  'myComponentA',
)
bom.components.add(componentA)
bom.metadata.component.dependencies.add(componentA.bomRef)

<script src="path-to-this-package/dist.web/lib.js"></script>
<script type="application/javascript">
    const CDX = CycloneDX_library

    let bom = new CDX.Models.Bom()
    bom.metadata.component = new CDX.Models.Component(
        CDX.Enums.ComponentType.Application,
        'MyProject'
    )
    const componentA = new CDX.Models.Component(
        CDX.Enums.ComponentType.Library,
        'myComponentA',
    )
    bom.components.add(componentA)
    bom.metadata.component.dependencies.add(componentA.bomRef)
</script>

There is no pre-rendered documentation at the time.
Instead, there are annotated type definitions, so that your IDE and tools may pick up the documentation when you use this library downstream.

Additionally, there is a prepared set of configs for TypeDoc, so that you can build the API documentation from source via npm run api-doc.

Feel free to open issues, bug reports or pull requests.
See the CONTRIBUTING file for details.

Permission to modify and redistribute is granted under the terms of the Apache 2.0 license.
See the LICENSE file for the full license.