Merge branch 'main' into sub_id-changes

Author: tulshi

openid-sharedsignals-framework-1_0.md

@@ -61,6 +61,12 @@ contributor:
         contribution: |
           Steve defined the format field of Complex Subjects
 
+      -
+        ins: A. Deshpande
+        name: Apoorva Deshpande
+        org: Okta
+        email: apoorva.deshpande@okta.com
+
 normative:
   CLIENTCRED:
     author:
@@ -848,9 +854,9 @@ following properties:
 
 stream_id
 
-> **Transmitter-Supplied**, A string that uniquely identifies the stream. Stream
-  IDs MUST be unique per Reciever.  This value is generated by the Transmitter
-  when the stream is created.
+> **Transmitter-Supplied**, A string that uniquely identifies the stream. A
+  transmitter MUST generate a unique ID for each of its non-deleted streams
+  at the time of stream creation.
 
 iss
 
@@ -879,13 +885,15 @@ events_requested
 > **Receiver-Supplied**, An array of URIs identifying the set of events that
   the Receiver requested. A Receiver SHOULD request only the events that it
   understands and it can act on. This is configurable by the Receiver. A
-  Transmitter MUST ignore any array values that it does not understand.
+  Transmitter MUST ignore any array values that it does not understand. This
+  array SHOULD NOT be empty.
 
 events_delivered
 
-> **Transmitter-Supplied**, An array of URIs which is the intersection of
-  "events_supported" and "events_requested". These events MAY be delivered over
-  the Event Stream. A Receiver MUST rely on the values received in this field
+> **Transmitter-Supplied**, An array of URIs identifying the set of events that
+  the Transmitter MUST include in the stream. This is a subset (not necessarily
+  a proper subset) of the intersection of "events_supported" and
+  "events_requested". A Receiver MUST rely on the values received in this field
   to understand which event types it can expect from the Transmitter.
 
 delivery
@@ -930,6 +938,13 @@ an HTTP POST request to the Configuration Endpoint. On receiving a valid request
 the Event Transmitter responds with a "201 Created" response containing a
 [JSON][RFC7159] representation of the stream’s configuration in the body.
 
+If a stream already exists, and the Transmitter allows multiple streams with the
+same Receiver, the Event Transmitter MUST respond with a new stream ID. If the
+Transmitter does not allow multiple streams with the same Receiver, it MUST respond
+respond with HTTP status code "409 Conflict". The Receiver MAY then GET the
+existing stream configuration and, if desired, use PATCH or PUT to update or
+replace the existing stream configuration.
+
 The HTTP POST request MAY contain the Receiver-Supplied values of the Stream
 Configuration ({{stream-config}}) object:
 
@@ -1006,6 +1021,7 @@ Errors are signaled with HTTP status codes as follows:
 | 400  | if the request cannot be parsed |
 | 401  | if authorization failed or it is missing |
 | 403  | if the Event Receiver is not allowed to create a stream |
+| 409  | if the transmitter does not support multiple streams per receiver |
 {: title="Create Stream Errors" #tablecreatestream}
 
 
@@ -1213,7 +1229,8 @@ configuration in the body.
 The stream_id property MUST be present in the request. Other properties
 MAY be present in the request. Any Receiver-Supplied property present in the
 request MUST be updated by the Transmitter. Any properties missing in the
-request MUST NOT be changed by the Transmitter.
+request MUST NOT be changed by the Transmitter. If `events_requested` property is
+included in the request, it SHOULD NOT be an empty array.
 
 Transmitter-Supplied properties beside the stream_id MAY be present,
 but they MUST match the expected value. Missing Transmitter-Supplied
@@ -1299,7 +1316,8 @@ The stream_id and the full set of Receiver-Supplied properties MUST be present
 in the PUT body, not only the ones that are specifically intended to be changed.
 Missing Receiver-Supplied properties MUST be interpreted as requested to be
 deleted. Event Receivers MAY read the configuration first, modify the JSON
-{{RFC7159}} representation, then make a replacement request.
+{{RFC7159}} representation, then make a replacement request. If `events_requested` 
+property is included in the request, it SHOULD NOT be an empty array.
 
 Transmitter-Supplied properties besides the stream_id MAY be present,
 but they MUST match the expected value. Missing Transmitter-Supplied