Merge pull request #215 from taleodor/2026-02-distro-type-remove

Use distributionId instead of distributionType to identifiy disributions

Author: oej

spec/openapi.yaml

@@ -12,7 +12,7 @@ info:
   license:
     name: Apache 2.0
     url: https://github.com/CycloneDX/transparency-exchange-api/blob/main/LICENSE
-  version: 0.3.0-beta.2
+  version: 0.4.0-beta.3
 servers:
   - url: http://localhost/tea/v1
     description: Local development
@@ -738,7 +738,7 @@ components:
             - idType: PURL
               idValue: pkg:maven/org.apache.tomcat/tomcat@11.0.7
           distributions:
-            - distributionType: zip
+            - distributionId: 6a0d58e1-4896-4f1e-83f7-5feb6c032537
               description: Core binary distribution, zip archive
               identifiers:
                 - idType: PURL
@@ -748,7 +748,7 @@ components:
                   algValue: 9da736a1cdd27231e70187cbc67398d29ca0b714f885e7032da9f1fb247693c1
               url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip
               signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip.asc
-            - distributionType: tar.gz
+            - distributionId: dba01c13-dd96-4928-be72-9c87ffa8cab8
               description: Core binary distribution, tar.gz archive
               identifiers:
                 - idType: PURL
@@ -758,7 +758,7 @@ components:
                   algValue: 2fcece641c62ba1f28e1d7b257493151fc44f161fb391015ee6a95fa71632fb9
               url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.tar.gz
               signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.tar.gz.asc
-            - distributionType: windows-x64.zip
+            - distributionId: cfe068c2-fae7-43d0-97ec-5ea092454040
               description: Core binary distribution, Windows x64 zip archive
               identifiers:
                 - idType: PURL
@@ -768,7 +768,7 @@ components:
                   algValue: 62a5c358d87a8ef21d7ec1b3b63c9bbb577453dda9c00cbb522b16cee6c23fc4
               url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6-windows-x64.zip
               signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip.asc
-            - distributionType: windows-x64.exe
+            - distributionId: de45ffaf-e4b5-47b5-be28-444a76df098e
               description: Core binary distribution, Windows Service Installer (MSI)
               checksums:
                 - algType: SHA_512
@@ -786,9 +786,9 @@ components:
     release-distribution:
       type: object
       properties:
-        distributionType:
-          type: string
-          description: Unique identifier for the distribution type.
+        distributionId:
+          description: A unique identifier for the TEA Distribution object
+          "$ref": "#/components/schemas/uuid"
         description:
           type: string
           description: Free-text description of the distribution.
@@ -811,9 +811,9 @@ components:
           items:
             "$ref": "#/components/schemas/checksum"
       required:
-        - id
+        - distributionId
       examples:
-        - distributionType: zip
+        - distributionId: 6a0d58e1-4896-4f1e-83f7-5feb6c032537
           description: Core binary distribution, zip archive
           identifiers:
             - idType: PURL
@@ -823,7 +823,7 @@ components:
               algValue: 9da736a1cdd27231e70187cbc67398d29ca0b714f885e7032da9f1fb247693c1
           url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip
           signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip.asc
-        - distributionType: tar.gz
+        - distributionId: dba01c13-dd96-4928-be72-9c87ffa8cab8
           description: Core binary distribution, tar.gz archive
           identifiers:
             - idType: PURL
@@ -833,7 +833,7 @@ components:
               algValue: 2fcece641c62ba1f28e1d7b257493151fc44f161fb391015ee6a95fa71632fb9
           url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.tar.gz
           signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.tar.gz.asc
-        - distributionType: windows-x64.zip
+        - distributionId: cfe068c2-fae7-43d0-97ec-5ea092454040
           description: Core binary distribution, Windows x64 zip archive
           identifiers:
             - idType: PURL
@@ -843,7 +843,7 @@ components:
               algValue: 62a5c358d87a8ef21d7ec1b3b63c9bbb577453dda9c00cbb522b16cee6c23fc4
           url: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6-windows-x64.zip
           signatureUrl: https://repo.maven.apache.org/maven2/org/apache/tomcat/tomcat/11.0.7/tomcat-11.0.6.zip.asc
-        - distributionType: windows-x64.exe
+        - distributionId: de45ffaf-e4b5-47b5-be28-444a76df098e
           description: Core binary distribution, Windows Service Installer (MSI)
           checksums:
             - algType: SHA_512
@@ -1011,22 +1011,26 @@ components:
         type:
           description: Type of TEA Artifact
           "$ref": "#/components/schemas/artifact-type"
-        distributionTypes:
+        distributionIds:
           type: array
           description: |
-            List of component distributions types that this TEA Artifact applies to.
-            If absent, the TEA Artifact applies to all distributions.
+            List of TEA Component Release distributions that this TEA Artifact applies to.
+            If absent or empty, the TEA Artifact applies to all distributions.
           items:
-            type: string
+            "$ref": "#/components/schemas/uuid"
             description: |
-              The `id` of the component format that this TEA Artifact applies to.
+              The distribution IDs of the TEA component release distributions that this TEA Artifact applies to.
         formats:
           type: array
           description: |
             List of objects with the same content, but in different formats.
             The order of the list has no significance.
           items:
             "$ref": "#/components/schemas/artifact-format"
+      required:
+        - uuid
+        - type
+        - formats
     artifact-type:
       type: string
       description: Specifies the type of external reference.
@@ -1048,7 +1052,7 @@ components:
       properties:
         mediaType:
           type: string
-          description: The MIME type of the document
+          description: The Media Type of the document
         description:
           type: string
           description: A free text describing the TEA Artifact
@@ -1074,6 +1078,9 @@ components:
         algValue:
           type: string
           description: Checksum value
+      required:
+        - algType
+        - algValue
     checksum-type:
       type: string
       description: Checksum algorithm