Mirrors/chatmail-core
1
0
Fork 0
mirror of https://github.com/chatmail/core.git synced 2026-05-08 17:36:29 +03:00
Code Issues Packages Projects Releases Wiki Activity

update spec to new Chat-User-Avatar usage

Browse Source
This commit is contained in:
B. Petersen
2021-06-10 13:24:57 +02:00
committed by bjoern
parent 4fe3a80f96
commit 056721b916
1 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
spec.md
View File

@@ -1,6 +1,6 @@
# chat-mail specification # chat-mail specification
Version: 0.32.0 Version: 0.33.0
Status: In-progress Status: In-progress
Format: [Semantic Line Breaks](https://sembr.org/) Format: [Semantic Line Breaks](https://sembr.org/)
@@ -301,9 +301,9 @@ to add a `Chat-Group-Avatar` only on image changes.
A user MAY have a profile-image that MAY be distributed to their contacts. A user MAY have a profile-image that MAY be distributed to their contacts.
To change or set the profile-image, To change or set the profile-image,
the messenger MUST attach an image file to a message the messenger MUST add the header `Chat-User-Avatar: base64:IMAGEDATA`.
and MUST add the header `Chat-User-Avatar` To bypass limits of headers, it is recommended not to use the outer header
with the value set to the image name. and to limit the size to 20k.
To remove the profile-image, To remove the profile-image,
the messenger MUST add the header `Chat-User-Avatar: 0`. the messenger MUST add the header `Chat-User-Avatar: 0`.
@@ -320,19 +320,14 @@ The messenger SHOULD NOT send an explicit mail to normal MUAs.
From: sender@domain From: sender@domain
To: rcpt@domain To: rcpt@domain
Chat-Version: 1.0 Chat-Version: 1.0
Chat-User-Avatar: photo.jpg
Subject: Chat: Hello, ... Subject: Chat: Hello, ...
Content-Type: multipart/mixed; boundary="==break==" Content-Type: multipart/mixed; boundary="==break=="
--==break== --==break==
Content-Type: text/plain Content-Type: text/plain
Chat-User-Avatar: base64:AKCgkJi3j4l5kjoldfUAKCgkJi3j4lldfHjgWICwgIEBQY ...
Hello, I've changed my profile image. Hello, I've changed my profile image.
--==break==
Content-Type: image/jpeg
Content-Disposition: attachment; filename="photo.jpg"
AKCgkJi3j4l5kjoldfUAKCgkJi3j4lldfHjgWICwgIEBQYFBA ...
--==break==-- --==break==--
The image format SHOULD be image/jpeg or image/png. The image format SHOULD be image/jpeg or image/png.
@@ -342,6 +337,11 @@ in the same message.
To save data, it is RECOMMENDED to add a `Chat-User-Avatar` header To save data, it is RECOMMENDED to add a `Chat-User-Avatar` header
only on image changes. only on image changes.
In older specs, the profile-image was sent as an attachment
and `Chat-User-Avatar:` specified its name.
However, it turned out that these attachements are kind of unuexpected to users,
therefore the profile-image go to the header now.
# Locations # Locations