fauna-api 1.0.783

The Fauna SDK for Rust: accounts, Drive, groups, calendar, chats, payments, Parrot and live rooms.
Documentation
use std::sync::{Arc, Mutex};

use fauna_api::view::{
    Kind, add_column, add_row, content_of, doc_from, format_csv, from_base64, kind_of, parse_csv,
    remove_column, remove_row, table_rows, to_base64,
};
use serde_json::{Value, json};
use yrs::updates::decoder::Decode;
use yrs::{Array, Doc, GetString, Map, Out, ReadTxn, StateVector, Text, Transact, Update};

fn text(bytes: Vec<u8>) -> String {
    String::from_utf8(bytes).unwrap()
}

fn apply(doc: &Doc, update: &[u8]) {
    doc.transact_mut()
        .apply_update(Update::decode_v1(update).unwrap())
        .unwrap();
}

fn ids(doc: &Doc, name: &str) -> Vec<String> {
    let array = doc.get_or_insert_array(name);
    let txn = doc.transact();
    array.iter(&txn).map(|out| out.to_string(&txn)).collect()
}

fn set_cell(doc: &Doc, row: &str, column: &str, value: &str) {
    let cells = doc.get_or_insert_map("cells");
    let mut txn = doc.transact_mut();
    let Some(Out::YMap(map)) = cells.get(&txn, row) else {
        panic!("row {row} has no cells");
    };
    map.insert(&mut txn, column, value);
}

#[test]
fn a_file_opens_as_text_table_image_or_view_by_type_name_and_size() {
    assert_eq!(kind_of("text/markdown", "plan.md", 100), Kind::Text);
    assert_eq!(
        kind_of("application/octet-stream", "app.py", 100),
        Kind::Text
    );
    assert_eq!(kind_of("text/csv", "data.csv", 100), Kind::Table);
    assert_eq!(
        kind_of("application/octet-stream", "data.csv", 100),
        Kind::Table
    );
    assert_eq!(kind_of("image/png", "shot.png", 50_000_000), Kind::Image);
    assert_eq!(kind_of("video/mp4", "clip.mp4", 100), Kind::View);
    assert_eq!(kind_of("application/pdf", "doc.pdf", 100), Kind::View);
    assert_eq!(
        kind_of("text/plain", "huge.txt", 2 * 1024 * 1024),
        Kind::View
    );
}

#[test]
fn csv_keeps_quoted_commas_quotes_and_line_breaks_through_a_round_trip() {
    let csv = "name,note\n\"Smith, Jo\",\"said \"\"hi\"\"\nthen left\"\nplain,\n";
    let rows = parse_csv(csv);
    assert_eq!(
        rows,
        vec![
            vec!["name", "note"],
            vec!["Smith, Jo", "said \"hi\"\nthen left"],
            vec!["plain", ""]
        ]
    );
    assert_eq!(parse_csv(&format_csv(&rows)), rows);
    assert_eq!(
        parse_csv("a,b\r\n1,2\r\n"),
        vec![vec!["a", "b"], vec!["1", "2"]]
    );
}

#[test]
fn a_table_document_saves_back_as_the_csv_it_came_from_with_edits() {
    let doc = doc_from(Kind::Table, Some(b"id,name\n1,Ada\n2,Grace\n"));
    assert_eq!(
        text(content_of(Kind::Table, &doc)),
        "id,name\n1,Ada\n2,Grace\n"
    );
    let rows = ids(&doc, "rows");
    let columns = ids(&doc, "columns");
    set_cell(&doc, &rows[1], &columns[1], "Ada Lovelace");
    let row = add_row(&doc, None);
    set_cell(&doc, &row, &columns[0], "3");
    let column = add_column(&doc, None);
    set_cell(&doc, &rows[0], &column, "born");
    assert_eq!(
        table_rows(&doc),
        vec![
            vec!["id", "name", "born"],
            vec!["1", "Ada Lovelace", ""],
            vec!["2", "Grace", ""],
            vec!["3", "", ""]
        ]
    );
    remove_row(&doc, &rows[2]);
    remove_column(&doc, &column);
    assert_eq!(
        text(content_of(Kind::Table, &doc)),
        "id,name\n1,Ada Lovelace\n3,\n"
    );
}

#[test]
fn two_editors_converge_on_the_same_text_whatever_order_their_edits_arrive_in() {
    let a = doc_from(Kind::Text, Some(b"hello world"));
    let b = Doc::new();
    apply(
        &b,
        &a.transact()
            .encode_state_as_update_v1(&StateVector::default()),
    );
    let from_a = Arc::new(Mutex::new(Vec::new()));
    let from_b = Arc::new(Mutex::new(Vec::new()));
    let sink = from_a.clone();
    let _a = a
        .observe_update_v1(move |_, event| sink.lock().unwrap().push(event.update.clone()))
        .unwrap();
    let sink = from_b.clone();
    let _b = b
        .observe_update_v1(move |_, event| sink.lock().unwrap().push(event.update.clone()))
        .unwrap();
    let text_a = a.get_or_insert_text("text");
    let text_b = b.get_or_insert_text("text");
    text_a.insert(&mut a.transact_mut(), 5, ",");
    text_b.insert(&mut b.transact_mut(), 11, "!");
    text_b.insert(&mut b.transact_mut(), 0, "Oh ");
    for update in from_b.lock().unwrap().iter() {
        apply(&a, &from_base64(&to_base64(update)).unwrap());
    }
    for update in from_a.lock().unwrap().iter().rev() {
        apply(&b, update);
    }
    assert_eq!(text_a.get_string(&a.transact()), "Oh hello, world!");
    assert_eq!(text_b.get_string(&b.transact()), "Oh hello, world!");
    assert_eq!(text(content_of(Kind::Text, &b)), "Oh hello, world!");
}

#[test]
fn an_image_document_is_its_marks_saved_as_json() {
    let mark = json!({ "id": "m1", "kind": "box", "points": [[0.1, 0.1], [0.5, 0.4]], "author": "a@faunakit.com", "color": "hsl(1 70% 50%)", "at": 1 });
    let doc = doc_from(Kind::Image, Some(json!([mark]).to_string().as_bytes()));
    assert_eq!(
        text(content_of(Kind::Image, &doc)),
        r#"[{"id":"m1","kind":"box","points":[[0.1,0.1],[0.5,0.4]],"author":"a@faunakit.com","color":"hsl(1 70% 50%)","at":1}]"#
    );
    let saved: Value = serde_json::from_slice(&content_of(Kind::Image, &doc)).unwrap();
    assert_eq!(saved, json!([mark]));
    assert_eq!(
        text(content_of(Kind::Image, &doc_from(Kind::Image, None))),
        "[]"
    );
    assert_eq!(
        text(content_of(
            Kind::Image,
            &doc_from(Kind::Image, Some(b"not json"))
        )),
        "[]"
    );
}

// Updates made by Yjs itself (`Y.encodeStateAsUpdate`), so file rooms read what
// browsers write.
#[test]
fn documents_read_updates_written_by_yjs() {
    let doc = Doc::new();
    apply(
        &doc,
        &from_base64("AQEHAAQBBHRleHQRaMOpbGxvIPCfkYsgd29ybGQA").unwrap(),
    );
    assert_eq!(text(content_of(Kind::Text, &doc)), "héllo 👋 world");

    let doc = Doc::new();
    apply(
        &doc,
        &from_base64("AQUIAAgBB2NvbHVtbnMCdwJjMXcCYzIIAQRyb3dzAXcCcjEnAQVjZWxscwJyMQEoAAgDAmMxAXcDQWRhKAAIAwJjMgF3BHgsIHkA")
            .unwrap(),
    );
    assert_eq!(text(content_of(Kind::Table, &doc)), "Ada,\"x, y\"\n");

    let doc = Doc::new();
    apply(
        &doc,
        &from_base64("AQEJAAgBBW1hcmtzAXYGAmlkdwJtMQRraW5kdwNib3gGcG9pbnRzdQJ1Ans/uZmZmZmZmnw+gAAAdQJ8PwAAAH0BBmF1dGhvcncOYUBmYXVuYWtpdC5jb20FY29sb3J3A3JlZAJhdHtCeSzAkUAAAAA=").unwrap(),
    );
    assert_eq!(
        text(content_of(Kind::Image, &doc)),
        r#"[{"id":"m1","kind":"box","points":[[0.1,0.25],[0.5,1]],"author":"a@faunakit.com","color":"red","at":1730000000000}]"#
    );
}