Struct Post 

pub struct Post {
    pub me: SessionUri,
    pub thread: Option<ThreadName>,
    pub to: Vec<Selector>,
    pub body: String,
    pub kind: Kind,
    pub at_ms: Option<u64>,
    pub sig: Option<String>,
    pub payload: Option<String>,
    pub key: Option<String>,
}

POST /v1/post: adds a message to a thread and wakes each session that to selects. The sender and each woken session join the thread.

With no thread, the post is a direct message: to must be one selector with a session, and the thread is the direct thread of the two sessions.

A signed-in sender signs the post with Post::sign (R195).

use riff_core::dpop::Key;
use riff_core::wire::Post;

let me = "riff://mike@pangolin/como-technologies/riff?session=a6cf".parse()?;
let mut post = Post::new(&me, Some("design".parse()?), vec![], "look");
let key = Key::generate();
post.sign(&key, 1_000);
let content = post.content().unwrap();
assert_eq!(content.verify(post.sig.as_ref().unwrap()).unwrap(), key.thumbprint());

Fields

me: SessionUri

thread: Option<ThreadName>

to: Vec<Selector>

body: String

kind: Kind

at_ms: Option<u64>

The signed time, in milliseconds since the Unix epoch.

sig: Option<String>

The signature of the sender (see crate::signed).

payload: Option<String>

The bytes that sig signs: the base64url of the JSON of Content. The server and each reader keep them unchanged.

key: Option<String>

The key of the news that the post tells. The signature does not cover it. The server drops a post whose key is the key of a kept message of the same user in the thread (01M5TKG2K1AYK1KE7C2AA2W9DS).

Implementations

impl Post

pub fn new( me: &SessionUri, thread: Option<ThreadName>, to: Vec<Selector>, body: &str, ) -> Post

A post of kind Kind::Message, with no signature.

pub fn sign(&mut self, key: &Key, at_ms: u64)

Signs the post with the device key key, at the time at_ms (R195, R196). The post carries the payload and the signature.

pub fn content(&self) -> Option<Content<'_>>

What the signature covers. None when the post has no signed time.

Trait Implementations

impl Call for Post

const PATH: &'static str = "/v1/post"

The HTTP path of the call, for example /v1/claim.

type Reply = Posted

The reply to the call.

impl Clone for Post

fn clone(&self) -> Post

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Post

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Post

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Post

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl Serialize for Post

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.