CCM-13475: Added event schema for the following events:

- PrintLetterAnalysed
- PrintLetterSafe
- PrintLetterQuarantined

Author: tdroza-nhs

docs/collections/_events/print-letter-analysed.md

@@ -7,4 +7,4 @@ schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025
 schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letters-print-letter-analysed-data.schema.json
 ---
 
-This event is published when a PDF letter has been analysed in preparation for sending to print. In addition to the standard metadata fields relating to the message request, the event payload also contains a count of the number of pages in the letter and a SHA256 has of the file. This information can be used by the Print Supplier API to verify the integrity of the letter before it is printed.
+This event is published when a PDF letter has been analysed in preparation for sending to print. In addition to the standard metadata fields relating to the message request, the event payload also contains a count of the number of pages in the letter and a SHA256 hash of the file. This information can be used by the Print Supplier API to verify the integrity of the letter before it is printed.

docs/collections/_events/print-letter-quarantined.md

@@ -0,0 +1,10 @@
+---
+title: print-letter-quarantined
+type: uk.nhs.notify.digital.letters.print.letter.quarantined.v1
+nice_name: PrintLetterQuarantined
+service: Print Supplier Services
+schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.letter.quarantined.v1.schema.json
+schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letters-print-letter-quarantined-data.schema.json
+---
+
+This event is published when a PDF letter has been virus scanned and found to contain potentially harmful content, resulting in it being quarantined.

docs/collections/_events/print-letter-safe.md

@@ -0,0 +1,10 @@
+---
+title: print-letter-safe
+type: uk.nhs.notify.digital.letters.print.letter.safe.v1
+nice_name: PrintLetterSafe
+service: Print Supplier Services
+schema_envelope:  https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.letter.safe.v1.schema.json
+schema_data: https://notify.nhs.uk/cloudevents/schemas/digital-letters/2025-10-draft/data/digital-letters-print-letter-safe-data.schema.json
+---
+
+This event is published when a PDF letter has been virus scanned and found to be free of harmful content, allowing it to be safely sent to print.

src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-analysed-data.schema.yaml

@@ -8,15 +8,18 @@ properties:
     $ref: ../defs/requests.schema.yaml#/properties/messageReference
   senderId:
     $ref: ../defs/requests.schema.yaml#/properties/senderId
-  messageUri:
-    $ref: ../defs/requests.schema.yaml#/properties/messageUri
+  letterUri:
+    $ref: ../defs/print.schema.yaml#/properties/letterUri
   pageCount:
     $ref: ../defs/print.schema.yaml#/properties/pageCount
   sha256Hash:
     $ref: ../defs/print.schema.yaml#/properties/sha256Hash
+  createdAt:
+    $ref: ../defs/print.schema.yaml#/properties/createdAt
 required:
   - messageReference
   - senderId
-  - messageUri
+  - letterUri
   - pageCount
   - sha256Hash
+  - createdAt

src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-quarantined-data.schema.yaml

@@ -0,0 +1,16 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+title: PrintLetterQuarantined Data
+description: Data payload of the PrintLetterQuarantined event
+type: object
+additionalProperties: false
+properties:
+  messageReference:
+    $ref: ../defs/requests.schema.yaml#/properties/messageReference
+  senderId:
+    $ref: ../defs/requests.schema.yaml#/properties/senderId
+  letterUri:
+    $ref: ../defs/print.schema.yaml#/properties/letterUri
+required:
+  - messageReference
+  - senderId
+  - letterUri

src/cloudevents/domains/digital-letters/2025-10-draft/data/digital-letters-print-letter-safe-data.schema.yaml

@@ -0,0 +1,16 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+title: PrintLetterSafe Data
+description: Data payload of the PrintLetterSafe event
+type: object
+additionalProperties: false
+properties:
+  messageReference:
+    $ref: ../defs/requests.schema.yaml#/properties/messageReference
+  senderId:
+    $ref: ../defs/requests.schema.yaml#/properties/senderId
+  letterUri:
+    $ref: ../defs/print.schema.yaml#/properties/letterUri
+required:
+  - messageReference
+  - senderId
+  - letterUri

src/cloudevents/domains/digital-letters/2025-10-draft/defs/print.schema.yaml

@@ -35,3 +35,17 @@ properties:
     examples:
       - 3a7bd3e2360a3d80c4d4e8b1e3e5e6e7e8e9e0e1e2e3e4e5e6e7e8e9e0e1e2e3
         abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890
+  letterUri:
+    type: string
+    format: uri
+    description: Uri to the S3 storage location of the PDF letter relating to this message request
+    examples:
+      - "s3://my-bucket/path/to/my-object"
+  createdAt:
+    title: "Created At DateTime"
+    description: "Timestamp when the letter was created (RFC 3339)."
+    examples: [
+      "2025-10-01T10:15:30.000Z"
+    ]
+    type: "string"
+    pattern: "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$"

src/cloudevents/domains/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.letter.analysed.v1.schema.yaml

@@ -12,7 +12,6 @@ properties:
     type: string
     pattern: ^/nhs/england/notify/(production|staging|development|uat)/(primary|secondary|dev-[0-9]+)/data-plane/digitalletters/print
     description: Event source for digital letters.
-
   dataschema:
     type: string
     const: ../data/digital-letters-print-letter-analysed-data.schema.yaml

src/cloudevents/domains/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.letter.quarantined.v1.schema.yaml

@@ -0,0 +1,22 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+title: PrintLetterQuarantined
+type: object
+allOf:
+  - $ref: ../digital-letters-print-profile.schema.yaml
+properties:
+  type:
+    type: string
+    const: uk.nhs.notify.digital.letters.print.letter.quarantined.v1
+    description: Concrete versioned event type string for this event (.vN suffix).
+  source:
+    type: string
+    pattern: ^/nhs/england/notify/(production|staging|development|uat)/(primary|secondary|dev-[0-9]+)/data-plane/digitalletters/print
+    description: Event source for digital letters.
+  dataschema:
+    type: string
+    const: ../data/digital-letters-print-letter-quarantined-data.schema.yaml
+    description: Canonical URI of the event's data schema.
+    examples:
+      - digital-letters-print-letter-quarantined-data.schema.yaml
+  data:
+    $ref: ../data/digital-letters-print-letter-quarantined-data.schema.yaml

src/cloudevents/domains/digital-letters/2025-10-draft/events/uk.nhs.notify.digital.letters.print.letter.safe.v1.schema.yaml

@@ -0,0 +1,22 @@
+$schema: https://json-schema.org/draft/2020-12/schema
+title: PrintLetterSafe
+type: object
+allOf:
+  - $ref: ../digital-letters-print-profile.schema.yaml
+properties:
+  type:
+    type: string
+    const: uk.nhs.notify.digital.letters.print.letter.safe.v1
+    description: Concrete versioned event type string for this event (.vN suffix).
+  source:
+    type: string
+    pattern: ^/nhs/england/notify/(production|staging|development|uat)/(primary|secondary|dev-[0-9]+)/data-plane/digitalletters/print
+    description: Event source for digital letters.
+  dataschema:
+    type: string
+    const: ../data/digital-letters-print-letter-safe-data.schema.yaml
+    description: Canonical URI of the event's data schema.
+    examples:
+      - digital-letters-print-letter-safe-data.schema.yaml
+  data:
+    $ref: ../data/digital-letters-print-letter-safe-data.schema.yaml