openapi: Update missingContent

Author: lann

crates/server/openapi.yaml

@@ -700,12 +700,9 @@ components:
           enum: [sourcing]
           example: sourcing
         missingContent:
-          type: array
-          description: The array of content digests that are missing for the package record.
+          "$ref": "#/components/schemas/MissingContentMap"
+          description: The missing content for the package record.
           minItems: 1
-          maxItems: 128
-          items:
-            "$ref": "#/components/schemas/AnyHash"
     ProcessingRecord:
       type: object
       description: A record that is being processed.
@@ -825,6 +822,44 @@ components:
           description: The algorithm-prefixed bytes of the signature (base64 encoded).
           pattern: ^[a-z0-9-]+:(?:[A-Za-z0-9+\/]{4})*(?:[A-Za-z0-9+\/]{4}|[A-Za-z0-9+\/]{3}=|[A-Za-z0-9+\/]{2}={2})$
           example: "ecdsa-p256:MEUCIQCzWZBW6ux9LecP66Y+hjmLZTP/hZVz7puzlPTXcRT2wwIgQZO7nxP0nugtw18MwHZ26ROFWcJmgCtKOguK031Y1D0="
+    MissingContentMap:
+      type: object
+      description: The map of content digest to missing content info.
+      patternProperties:
+        "^[a-z0-9-]+:[a-f0-9]+$":
+          "$ref": "#/components/schemas/MissingContent"
+      example:
+        ? "sha256:7d865e959b2466918c9863afca942d0fb89d7c9ac0c99bafc3749504ded9773"
+        : upload:
+            - type: http-post
+              url: https://example.com/7d865e959b2466918c9863afca942d0fb89d7c9ac0c99bafc3749504ded9773
+    MissingContent:
+      description: Information about missing content.
+      properties:
+        upload:
+          description: Upload endpoint(s) for the missing content.
+          type: array 
+          items:
+            oneOf:
+              - "$ref": "#/components/schemas/HttpPostUpload"
+            discriminator:
+              propertyName: type
+              mapping:
+                http-post: "#/components/schemas/HttpPostUpload"
+    HttpPostUpload:
+      type: object
+      description: A HTTP POST upload endpoint.
+      properties:
+        type:
+          type: string
+          description: The type of upload endpoint.
+          enum: [http-post]
+          example: http-post
+        url:
+          type: string
+          description: The URL of the upload endpoint.
+          example: https://example.com/contents.wasm
+          format: uri
     ContentSourceMap:
       type: object
       description: The map of content digest to sources.