diff options
| author | Terry Yiu <963907+tyiu@users.noreply.github.com> | 2024-08-06 23:55:47 -0400 |
|---|---|---|
| committer | Terry Yiu <963907+tyiu@users.noreply.github.com> | 2024-08-06 23:55:47 -0400 |
| commit | dea4bebf4b1bf36feeb8a066bccf62b9b1aeb5c5 (patch) | |
| tree | b2406f53523e6796e56c2c020c46be4a8d183a52 /52.md | |
| parent | 738c4809a146187b9a2f494f180ce6d770307830 (diff) | |
Amend NIP-52 to include e and p tags to calendar event RSVPs
Diffstat (limited to '52.md')
| -rw-r--r-- | 52.md | 14 |
1 files changed, 12 insertions, 2 deletions
| @@ -178,6 +178,12 @@ This NIP is intentionally not defining who is authorized to attend a calendar ev | |||
| 178 | 178 | ||
| 179 | This NIP is also intentionally not defining what happens if a calendar event changes after an RSVP is submitted. | 179 | This NIP is also intentionally not defining what happens if a calendar event changes after an RSVP is submitted. |
| 180 | 180 | ||
| 181 | The RSVP MUST tag the calendar event it is in response to with an `e` tag on the calendar event's id. | ||
| 182 | |||
| 183 | The RSVP MAY tag use an `a` tag to the calendar event's event coordinates to indicate that the RSVP response could hold trueregardless of any future revisions to the calendar event. If the `a` tag is omitted, the author of the RSVP is explicitly indicating that its response holds true for only that specific revision of the calendar event from the `e` tag. | ||
| 184 | |||
| 185 | The RSVP MAY tag the author of the calendar event it is in response to using a `p` tag so that clients can easily query all RSVPs that pertain to the author. | ||
| 186 | |||
| 181 | ### Format | 187 | ### Format |
| 182 | 188 | ||
| 183 | The format uses a parameterized replaceable event kind `31925`. | 189 | The format uses a parameterized replaceable event kind `31925`. |
| @@ -185,10 +191,12 @@ The format uses a parameterized replaceable event kind `31925`. | |||
| 185 | The `.content` of these events is optional and should be a free-form note that adds more context to this calendar event response. | 191 | The `.content` of these events is optional and should be a free-form note that adds more context to this calendar event response. |
| 186 | 192 | ||
| 187 | The list of tags are as follows: | 193 | The list of tags are as follows: |
| 188 | * `a` (required) reference tag to kind `31922` or `31923` calendar event being responded to. | 194 | * `e` (required) event tag to kind `31922` or `31923` calendar event being responded to. |
| 195 | * `a` (optional) reference tag to kind `31922` or `31923` calendar event being responded to. | ||
| 189 | * `d` (required) universally unique identifier. Generated by the client creating the calendar event RSVP. | 196 | * `d` (required) universally unique identifier. Generated by the client creating the calendar event RSVP. |
| 190 | * `status` (required) `accepted`, `declined`, or `tentative`. Determines attendance status to the referenced calendar event. | 197 | * `status` (required) `accepted`, `declined`, or `tentative`. Determines attendance status to the referenced calendar event. |
| 191 | * `fb` (optional) `free` or `busy`. Determines if the user would be free or busy for the duration of the calendar event. This tag must be omitted or ignored if the `status` label is set to `declined`. | 198 | * `fb` (optional) `free` or `busy`. Determines if the user would be free or busy for the duration of the calendar event. This tag must be omitted or ignored if the `status` label is set to `declined`. |
| 199 | * `p` (optional) author of the calendar event being responded to. | ||
| 192 | 200 | ||
| 193 | ```json | 201 | ```json |
| 194 | { | 202 | { |
| @@ -198,10 +206,12 @@ The list of tags are as follows: | |||
| 198 | "kind": 31925, | 206 | "kind": 31925, |
| 199 | "content": "<note>", | 207 | "content": "<note>", |
| 200 | "tags": [ | 208 | "tags": [ |
| 201 | ["a", "<31922 or 31923>:<calendar event author pubkey>:<d-identifier of calendar event>", "<optional relay url>"], | 209 | ["e", "<kind 31922 or 31923 event id", "<optional recommended relay URL>"] |
| 210 | ["a", "<31922 or 31923>:<calendar event author pubkey>:<d-identifier of calendar event>", "<optional recommended relay URL>"], | ||
| 202 | ["d", "<UUID>"], | 211 | ["d", "<UUID>"], |
| 203 | ["status", "<accepted/declined/tentative>"], | 212 | ["status", "<accepted/declined/tentative>"], |
| 204 | ["fb", "<free/busy>"], | 213 | ["fb", "<free/busy>"], |
| 214 | ["p", "<hex pubkey of kind 31922 or 31923 event>", "<optional recommended relay URL>"] | ||
| 205 | ] | 215 | ] |
| 206 | } | 216 | } |
| 207 | ``` | 217 | ``` |