From 8cfe326d353d802dac2417c55776c2c1f3e47ce5 Mon Sep 17 00:00:00 2001
From: Paul Campbell <campbjpa@amazon.com>
Date: Sat, 30 Nov 2024 11:30:36 +0000
Subject: [PATCH] WIP(TODO): define nextcloud config model client

---
 src/config.rs                                 |  50 +++-
 src/lib.rs                                    |   4 +-
 src/nextcloud/board.rs                        |  22 ++
 src/nextcloud/mod.rs                          | 129 ++++++++++
 src/nextcloud/model.rs                        | 168 +++++++++++++
 src/nextcloud/stack.rs                        |  19 ++
 src/nextcloud/tests.rs                        | 221 ++++++++++++++++++
 src/tests/responses/nextcloud-boards.json     |  86 +++++++
 src/tests/responses/nextcloud-stack-list.json | 216 +++++++++++++++++
 9 files changed, 904 insertions(+), 11 deletions(-)
 create mode 100644 src/nextcloud/board.rs
 create mode 100644 src/nextcloud/mod.rs
 create mode 100644 src/nextcloud/model.rs
 create mode 100644 src/nextcloud/stack.rs
 create mode 100644 src/nextcloud/tests.rs
 create mode 100644 src/tests/responses/nextcloud-boards.json
 create mode 100644 src/tests/responses/nextcloud-stack-list.json

diff --git a/src/config.rs b/src/config.rs
index 398d434..0f3a9b7 100644
--- a/src/config.rs
+++ b/src/config.rs
@@ -1,16 +1,13 @@
 //
 // use color_eyre::Result;
 
-// use crate::{
-// f, s,
-// trello::{
-//     types::{
-//         auth::{TrelloApiKey, TrelloApiSecret, TrelloAuth, TrelloUser},
-//         TrelloBoardName,
-//     }
-// },
-// Ctx, NAME,
-// };
+use crate::{
+    // f,
+    nextcloud::model::{NextcloudBoardId, NextcloudHostname, NextcloudPassword, NextcloudUsername},
+    // s,
+    // trello::types::{TrelloApiKey, TrelloApiSecret, TrelloAuth, TrelloBoardName, TrelloUser},
+    // Ctx, NAME,
+};
 
 #[derive(
     Clone,
@@ -48,6 +45,38 @@ pub struct TrelloConfig {
 // }
 // }
 
+#[derive(
+    Clone,
+    Debug,
+    derive_more::From,
+    PartialEq,
+    Eq,
+    PartialOrd,
+    Ord,
+    serde::Deserialize,
+    derive_more::Constructor,
+)]
+pub struct NextcloudConfig {
+    hostname: NextcloudHostname,
+    username: NextcloudUsername,
+    password: NextcloudPassword,
+    board_id: NextcloudBoardId,
+}
+impl NextcloudConfig {
+    pub fn hostname(&self) -> &NextcloudHostname {
+        &self.hostname
+    }
+    pub fn username(&self) -> &NextcloudUsername {
+        &self.username
+    }
+    pub fn password(&self) -> &NextcloudPassword {
+        &self.password
+    }
+    pub fn board_id(&self) -> NextcloudBoardId {
+        self.board_id
+    }
+}
+
 #[derive(
     Clone,
     Debug,
@@ -62,6 +91,7 @@ pub struct TrelloConfig {
 )]
 pub struct AppConfig {
     pub trello: TrelloConfig,
+    pub nextcloud: NextcloudConfig,
 }
 // impl AppConfig {
 //     pub fn load(ctx: &Ctx) -> Result<Self> {
diff --git a/src/lib.rs b/src/lib.rs
index be0077d..fe20602 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -2,12 +2,14 @@
 use std::path::PathBuf;
 
 use clap::Parser;
+pub use config::AppConfig;
 use kxio::{fs::FileSystem, net::Net};
 
-// mod api_result;
+mod api_result;
 mod config;
 mod init;
 mod macros;
+pub mod nextcloud;
 mod template;
 // mod trello;
 
diff --git a/src/nextcloud/board.rs b/src/nextcloud/board.rs
new file mode 100644
index 0000000..de3db0b
--- /dev/null
+++ b/src/nextcloud/board.rs
@@ -0,0 +1,22 @@
+//
+use kxio::net::Net;
+
+use crate::{p, AppConfig, Ctx};
+use crate::{p, FullCtx};
+ 
+use super::DeckClient;
+ 
+pub async fn list(ctx: FullCtx, dump: bool) -> color_eyre::Result<()> {
+    let dc = DeckClient::new(&ctx.cfg.nextcloud, ctx.net);
+     let apiresult = dc.get_boards().await;
+     if dump {
+         p!("{}", apiresult.text);
+     } else {
+         let mut boards = apiresult.result?;
+         boards.sort_by_key(|stack| stack.title.clone());
+         boards
+             .iter()
+             .for_each(|stack| p!("{}:{}", stack.id, stack.title));
+     }
+     Ok(())
+ }
diff --git a/src/nextcloud/mod.rs b/src/nextcloud/mod.rs
new file mode 100644
index 0000000..0a01925
--- /dev/null
+++ b/src/nextcloud/mod.rs
@@ -0,0 +1,129 @@
+//
+use kxio::net::Net;
+
+use crate::api_result::APIResult;
+use crate::{config::NextcloudConfig, f};
+
+use model::{Board, Card, NextcloudBoardId, Stack};
+
+pub mod model;
+
+#[cfg(test)]
+mod tests;
+
+pub struct DeckClient {
+    net: Net,
+    hostname: String,
+    username: String,
+    password: String,
+}
+
+impl DeckClient {
+    pub fn new(cfg: &NextcloudConfig, net: Net) -> Self {
+        let hostname = cfg.hostname().to_string();
+        let username = cfg.username().to_string();
+        let password = cfg.password().to_string();
+
+        Self {
+            net,
+            hostname,
+            username,
+            password,
+        }
+    }
+
+    fn url(&self, path: impl Into<String>) -> String {
+        f!(
+            "https://{}/index.php/apps/deck/api/v1.0/{}",
+            self.hostname,
+            path.into()
+        )
+    }
+
+    pub async fn get_boards(&self) -> APIResult<Vec<Board>> {
+        APIResult::new(
+            self.net
+                .get(self.url("boards"))
+                .basic_auth(&self.username, Some(&self.password))
+                .header("accept", "application/json")
+                .send()
+                .await,
+        )
+        .await
+    }
+
+    pub async fn get_board(&self, board_id: NextcloudBoardId) -> APIResult<Board> {
+        APIResult::new(
+            self.net
+                .get(self.url(f!("boards/{board_id}")))
+                .basic_auth(&self.username, Some(&self.password))
+                .header("accept", "application/json")
+                .send()
+                .await,
+        )
+        .await
+    }
+
+    pub async fn create_board(&self, title: &str, color: &str) -> APIResult<Board> {
+        APIResult::new(
+            self.net
+                .post(self.url("boards"))
+                .basic_auth(&self.username, Some(&self.password))
+                .header("accept", "application/json")
+                .body(
+                    serde_json::json!({
+                        "title": title,
+                        "color": color
+                    })
+                    .to_string(),
+                )
+                .send()
+                .await,
+        )
+        .await
+    }
+
+    pub async fn get_stacks(&self, board_id: NextcloudBoardId) -> APIResult<Vec<Stack>> {
+        APIResult::new(
+            self.net
+                .get(self.url(f!("boards/{board_id}/stacks")))
+                .basic_auth(&self.username, Some(&self.password))
+                .header("accept", "application/json")
+                .send()
+                .await,
+        )
+        .await
+    }
+
+    pub async fn create_card(
+        &self,
+        board_id: i64,
+        stack_id: i64,
+        title: &str,
+        description: Option<&str>,
+    ) -> APIResult<Card> {
+        let url = format!(
+            "https://{}/index.php/apps/deck/api/v1.0/boards/{}/stacks/{}/cards",
+            self.hostname, board_id, stack_id
+        );
+
+        let mut json = serde_json::json!({
+            "title": title,
+        });
+
+        if let Some(desc) = description {
+            json["description"] = serde_json::Value::String(desc.to_string());
+        }
+
+        APIResult::new(
+            self.net
+                .post(&url)
+                .basic_auth(&self.username, Some(&self.password))
+                .header("accept", "application/json")
+                .body(json.to_string())
+                .send()
+                .await,
+        )
+        .await
+    }
+}
diff --git a/src/nextcloud/model.rs b/src/nextcloud/model.rs
new file mode 100644
index 0000000..94fc87f
--- /dev/null
+++ b/src/nextcloud/model.rs
@@ -0,0 +1,168 @@
+use derive_more::derive::Display;
+//
+use serde::{Deserialize, Serialize};
+
+use crate::newtype;
+
+newtype!(
+    NextcloudHostname,
+    String,
+    Display,
+    PartialOrd,
+    Ord,
+    "Hostname of the Nextcloud server"
+);
+newtype!(
+    NextcloudUsername,
+    String,
+    Display,
+    PartialOrd,
+    Ord,
+    "Username to authenticate as"
+);
+newtype!(
+    NextcloudPassword,
+    String,
+    PartialOrd,
+    Ord,
+    "Password to authenticate with"
+);
+
+newtype!(
+    NextcloudBoardId,
+    i64,
+    Copy,
+    Display,
+    PartialOrd,
+    Ord,
+    "ID of a Nextcloud Board"
+);
+newtype!(
+    NextcloudStackId,
+    i64,
+    Copy,
+    Display,
+    PartialOrd,
+    Ord,
+    "ID of a Nextcloud Stack"
+);
+newtype!(
+    NextcloudCardId,
+    i64,
+    Copy,
+    Display,
+    PartialOrd,
+    Ord,
+    "ID of a Nextcloud Card"
+);
+newtype!(
+    NextcloudLabelId,
+    i64,
+    Copy,
+    Display,
+    PartialOrd,
+    Ord,
+    "ID of a Nextcloud Label"
+);
+newtype!(
+    NextcloudOrder,
+    i64,
+    Copy,
+    Display,
+    PartialOrd,
+    Ord,
+    "Relative position of the item amongst its peers"
+);
+newtype!(
+    NextcloudETag,
+    String,
+    PartialOrd,
+    Ord,
+    "ETag for a resource"
+);
+newtype!(
+    NextcloudBoardTitle,
+    String,
+    PartialOrd,
+    Ord,
+    "Title of the Board"
+);
+newtype!(
+    NextcloudBoardOwner,
+    String,
+    PartialOrd,
+    Ord,
+    "Owner of the Board"
+);
+newtype!(
+    NextcloudBoardColour,
+    String,
+    PartialOrd,
+    Ord,
+    "Colour of the Board"
+);
+
+newtype!(
+    NextcloudStackTitle,
+    String,
+    PartialOrd,
+    Ord,
+    "Title of the Stack"
+);
+newtype!(
+    NextcloudCardTitle,
+    String,
+    PartialOrd,
+    Ord,
+    "Title of the Card"
+);
+
+#[derive(Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
+pub struct Board {
+    pub id: NextcloudBoardId,
+    pub title: NextcloudBoardTitle,
+    pub owner: NextcloudBoardOwner,
+    pub color: NextcloudBoardColour,
+    pub archived: bool,
+    pub labels: Vec<Label>,
+    pub acl: Vec<Acl>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
+pub struct Stack {
+    pub id: NextcloudStackId,
+    pub title: NextcloudStackTitle,
+    pub order: NextcloudOrder,
+    #[serde(rename = "boardId")]
+    pub board_id: NextcloudBoardId,
+    #[serde(rename = "ETag")]
+    pub etag: NextcloudETag,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize)]
+pub struct Card {
+    pub id: NextcloudCardId,
+    pub title: NextcloudCardTitle,
+    pub description: Option<String>,
+    #[serde(rename = "stackId")]
+    pub stack_id: NextcloudStackId,
+    pub order: NextcloudOrder,
+    pub archived: bool,
+    pub due_date: Option<String>,
+    pub labels: Vec<NextcloudLabelId>,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
+pub struct Label {
+    pub id: NextcloudLabelId,
+    pub title: String,
+    pub color: String,
+}
+
+#[derive(Clone, Debug, Serialize, Deserialize, PartialEq, Eq, PartialOrd, Ord)]
+pub struct Acl {
+    pub participant: String,
+    pub permission_edit: bool,
+    pub permission_share: bool,
+    pub permission_manage: bool,
+}
diff --git a/src/nextcloud/stack.rs b/src/nextcloud/stack.rs
new file mode 100644
index 0000000..26a0e0f
--- /dev/null
+++ b/src/nextcloud/stack.rs
@@ -0,0 +1,19 @@
+//
+use crate::{p, FullCtx};
+
+use super::DeckClient;
+
+pub async fn list(ctx: FullCtx, dump: bool) -> color_eyre::Result<()> {
+    let dc = DeckClient::new(&ctx.cfg.nextcloud, ctx.net);
+    let apiresult = dc.get_stacks(ctx.cfg.nextcloud.board_id()).await;
+    if dump {
+        p!("{}", apiresult.text);
+    } else {
+        let mut stacks = apiresult.result?;
+        stacks.sort_by_key(|stack| stack.order);
+        stacks
+            .iter()
+            .for_each(|stack| p!("{}:{}", stack.id, stack.title));
+    }
+    Ok(())
+}
diff --git a/src/nextcloud/tests.rs b/src/nextcloud/tests.rs
new file mode 100644
index 0000000..3518cbc
--- /dev/null
+++ b/src/nextcloud/tests.rs
@@ -0,0 +1,221 @@
+//
+use crate::{
+    config::NextcloudConfig,
+    nextcloud::{
+        model::{NextcloudBoardId, NextcloudHostname, NextcloudPassword, NextcloudUsername},
+        DeckClient,
+    },
+};
+
+mod config {
+    use super::*;
+
+    #[test]
+    fn config_hostname_returns_hostname() {
+        //given
+        let hostname = NextcloudHostname::new("host-name");
+        let username = NextcloudUsername::new("username");
+        let password = NextcloudPassword::new("password");
+        let board_id = NextcloudBoardId::new(2);
+        let cfg = NextcloudConfig::new(hostname.clone(), username, password, board_id);
+
+        //when
+        let result = cfg.hostname();
+
+        //then
+        assert_eq!(result, &hostname);
+    }
+
+    #[test]
+    fn config_username_returns_username() {
+        //given
+        let hostname = NextcloudHostname::new("host-name");
+        let username = NextcloudUsername::new("username");
+        let password = NextcloudPassword::new("password");
+        let board_id = NextcloudBoardId::new(2);
+        let cfg = NextcloudConfig::new(hostname, username.clone(), password, board_id);
+
+        //when
+        let result = cfg.username();
+
+        //then
+        assert_eq!(result, &username);
+    }
+
+    #[test]
+    fn config_password_returns_password() {
+        //given
+        let hostname = NextcloudHostname::new("host-name");
+        let username = NextcloudUsername::new("username");
+        let password = NextcloudPassword::new("password");
+        let board_id = NextcloudBoardId::new(2);
+        let cfg = NextcloudConfig::new(hostname, username, password.clone(), board_id);
+
+        //when
+        let result = cfg.password();
+
+        //then
+        assert_eq!(result, &password);
+    }
+
+    #[test]
+    fn config_board_id_returns_board_id() {
+        //given
+        let hostname = NextcloudHostname::new("host-name");
+        let username = NextcloudUsername::new("username");
+        let password = NextcloudPassword::new("password");
+        let board_id = NextcloudBoardId::new(2);
+        let cfg = NextcloudConfig::new(hostname, username, password, board_id);
+
+        //when
+        let result = cfg.board_id();
+
+        //then
+        assert_eq!(result, board_id);
+    }
+}
+
+mod client {
+    use kxio::net::StatusCode;
+    use serde_json::json;
+
+    use crate::{
+        nextcloud::model::{
+            Acl, Board, Label, NextcloudBoardColour, NextcloudBoardOwner, NextcloudBoardTitle,
+            NextcloudETag, NextcloudLabelId, NextcloudOrder, NextcloudStackId, NextcloudStackTitle,
+            Stack,
+        },
+        s,
+    };
+
+    use super::*;
+
+    #[tokio::test]
+    async fn get_boards() {
+        //given
+        let mock_net = kxio::net::mock();
+
+        mock_net
+            .on()
+            .get("https://host-name/index.php/apps/deck/api/v1.0/boards")
+            .basic_auth("username", Some("password"))
+            .respond(StatusCode::OK)
+            .body(
+                json!([{
+                    "id":2,
+                    "title":"board-title",
+                    "owner":"owner",
+                    "color":"red",
+                    "archived":false,
+                    "labels":[
+                        {
+                            "id":2,
+                            "title":"label-title",
+                            "color":"blue"
+                        }
+                    ],
+                    "acl":[
+                        {
+                            "participant":"participant",
+                            "permission_edit":true,
+                            "permission_share":false,
+                            "permission_manage":true
+                        }
+                    ]
+                }])
+                .to_string(),
+            )
+            .expect("mock request");
+
+        let cfg = given::a_nextcloud_config();
+        let deck_client = DeckClient::new(&cfg, mock_net.into());
+
+        //when
+        let result = deck_client.get_boards().await.result.expect("get boards");
+
+        assert_eq!(
+            result,
+            vec![Board {
+                id: NextcloudBoardId::new(2),
+                title: NextcloudBoardTitle::new("board-title"),
+                owner: NextcloudBoardOwner::new("owner"),
+                color: NextcloudBoardColour::new("red"),
+                archived: false,
+                labels: vec![Label {
+                    id: NextcloudLabelId::new(2),
+                    title: s!("label-title"),
+                    color: s!("blue")
+                }],
+                acl: vec![Acl {
+                    participant: s!("participant"),
+                    permission_edit: true,
+                    permission_share: false,
+                    permission_manage: true
+                }]
+            }]
+        );
+    }
+
+    #[tokio::test]
+    async fn get_stacks() {
+        //given
+        let mock_net = kxio::net::mock();
+
+        mock_net
+            .on()
+            .get("https://host-name/index.php/apps/deck/api/v1.0/boards/2/stacks")
+            .basic_auth("username", Some("password"))
+            .respond(StatusCode::OK)
+            .body(include_str!("../tests/responses/nextcloud-stack-list.json"))
+            .expect("mock request");
+
+        let cfg = given::a_nextcloud_config();
+        let deck_client = DeckClient::new(&cfg, mock_net.into());
+
+        //when
+        let result = deck_client
+            .get_stacks(cfg.board_id())
+            .await
+            .result
+            .expect("get stacks");
+
+        assert_eq!(
+            result,
+            vec![
+                Stack {
+                    id: NextcloudStackId::new(3),
+                    title: NextcloudStackTitle::new("Done"),
+                    order: NextcloudOrder::new(2),
+                    board_id: NextcloudBoardId::new(1),
+                    etag: NextcloudETag::new("97592874d17017ef4f620c9c2a490086")
+                },
+                Stack {
+                    id: NextcloudStackId::new(2),
+                    title: NextcloudStackTitle::new("Doing"),
+                    order: NextcloudOrder::new(1),
+                    board_id: NextcloudBoardId::new(1),
+                    etag: NextcloudETag::new("3da05f904903c88450b79e4f8f6e2160")
+                },
+                Stack {
+                    id: NextcloudStackId::new(1),
+                    title: NextcloudStackTitle::new("To do"),
+                    order: NextcloudOrder::new(0),
+                    board_id: NextcloudBoardId::new(1),
+                    etag: NextcloudETag::new("b567d287210fa4d9b108ac68d5b087c1")
+                }
+            ]
+        );
+    }
+}
+
+mod given {
+    use super::*;
+
+    pub fn a_nextcloud_config() -> NextcloudConfig {
+        let hostname = NextcloudHostname::new("host-name");
+        let username = NextcloudUsername::new("username");
+        let password = NextcloudPassword::new("password");
+        let board_id = NextcloudBoardId::new(2);
+        NextcloudConfig::new(hostname, username, password, board_id)
+    }
+}
diff --git a/src/tests/responses/nextcloud-boards.json b/src/tests/responses/nextcloud-boards.json
new file mode 100644
index 0000000..d28ee80
--- /dev/null
+++ b/src/tests/responses/nextcloud-boards.json
@@ -0,0 +1,86 @@
+[
+  {
+    "id": 1,
+    "title": "Personal Board",
+    "owner": {
+      "primaryKey": "pcampbell",
+      "uid": "pcampbell",
+      "displayname": "Paul Campbell",
+      "type": 0
+    },
+    "color": "0087C5",
+    "archived": false,
+    "labels": [],
+    "acl": [],
+    "permissions": {
+      "PERMISSION_READ": true,
+      "PERMISSION_EDIT": true,
+      "PERMISSION_MANAGE": true,
+      "PERMISSION_SHARE": true
+    },
+    "users": [],
+    "shared": 0,
+    "stacks": [],
+    "activeSessions": [],
+    "deletedAt": 0,
+    "lastModified": 1733337423,
+    "settings": [],
+    "ETag": "b567d287210fa4d9b108ac68d5b087c1"
+  },
+  {
+    "id": 4,
+    "title": "4 Published: Cossmass Infinities",
+    "owner": {
+      "primaryKey": "pcampbell",
+      "uid": "pcampbell",
+      "displayname": "Paul Campbell",
+      "type": 0
+    },
+    "color": "ff0000",
+    "archived": true,
+    "labels": [],
+    "acl": [],
+    "permissions": {
+      "PERMISSION_READ": true,
+      "PERMISSION_EDIT": true,
+      "PERMISSION_MANAGE": true,
+      "PERMISSION_SHARE": true
+    },
+    "users": [],
+    "shared": 0,
+    "stacks": [],
+    "activeSessions": [],
+    "deletedAt": 0,
+    "lastModified": 1699798570,
+    "settings": [],
+    "ETag": "5e0fe035f3b95672da3cba633086be37"
+  },
+  {
+    "id": 5,
+    "title": "Fulfilment: Cossmass Infinities",
+    "owner": {
+      "primaryKey": "pcampbell",
+      "uid": "pcampbell",
+      "displayname": "Paul Campbell",
+      "type": 0
+    },
+    "color": "ff0000",
+    "archived": true,
+    "labels": [],
+    "acl": [],
+    "permissions": {
+      "PERMISSION_READ": true,
+      "PERMISSION_EDIT": true,
+      "PERMISSION_MANAGE": true,
+      "PERMISSION_SHARE": true
+    },
+    "users": [],
+    "shared": 0,
+    "stacks": [],
+    "activeSessions": [],
+    "deletedAt": 0,
+    "lastModified": 1699798567,
+    "settings": [],
+    "ETag": "90e2f9d53c5f6ec83088425d4486e54d"
+  }
+]
diff --git a/src/tests/responses/nextcloud-stack-list.json b/src/tests/responses/nextcloud-stack-list.json
new file mode 100644
index 0000000..a9b42bd
--- /dev/null
+++ b/src/tests/responses/nextcloud-stack-list.json
@@ -0,0 +1,216 @@
+[
+  {
+    "id": 3,
+    "title": "Done",
+    "boardId": 1,
+    "deletedAt": 0,
+    "lastModified": 1733337412,
+    "cards": [
+      {
+        "id": 322,
+        "title": "Lunch: Soup & Toast",
+        "description": "",
+        "stackId": 3,
+        "type": "plain",
+        "lastModified": 1733337412,
+        "lastEditor": null,
+        "createdAt": 1733043472,
+        "labels": [],
+        "assignedUsers": [
+          {
+            "id": 25,
+            "participant": {
+              "primaryKey": "pcampbell",
+              "uid": "pcampbell",
+              "displayname": "Paul Campbell",
+              "type": 0
+            },
+            "cardId": 322,
+            "type": 0
+          }
+        ],
+        "attachments": null,
+        "attachmentCount": 0,
+        "owner": {
+          "primaryKey": "pcampbell",
+          "uid": "pcampbell",
+          "displayname": "Paul Campbell",
+          "type": 0
+        },
+        "order": 0,
+        "archived": false,
+        "done": null,
+        "duedate": null,
+        "deletedAt": 0,
+        "commentsUnread": 0,
+        "commentsCount": 0,
+        "ETag": "97592874d17017ef4f620c9c2a490086",
+        "overdue": 0
+      }
+    ],
+    "order": 2,
+    "ETag": "97592874d17017ef4f620c9c2a490086"
+  },
+  {
+    "id": 2,
+    "title": "Doing",
+    "boardId": 1,
+    "deletedAt": 0,
+    "lastModified": 1733337420,
+    "cards": [
+      {
+        "id": 319,
+        "title": "That",
+        "description": "",
+        "stackId": 2,
+        "type": "plain",
+        "lastModified": 1733335979,
+        "lastEditor": null,
+        "createdAt": 1732610551,
+        "labels": [],
+        "assignedUsers": [],
+        "attachments": null,
+        "attachmentCount": 1,
+        "owner": {
+          "primaryKey": "pcampbell",
+          "uid": "pcampbell",
+          "displayname": "Paul Campbell",
+          "type": 0
+        },
+        "order": 0,
+        "archived": false,
+        "done": null,
+        "duedate": null,
+        "deletedAt": 0,
+        "commentsUnread": 0,
+        "commentsCount": 0,
+        "ETag": "79aeb703494e67736cc66b35053d258d",
+        "overdue": 0
+      },
+      {
+        "id": 323,
+        "title": "Second lunch: Poached Egg & Toasted Muffin",
+        "description": "",
+        "stackId": 2,
+        "type": "plain",
+        "lastModified": 1733337420,
+        "lastEditor": null,
+        "createdAt": 1733043481,
+        "labels": [],
+        "assignedUsers": [
+          {
+            "id": 26,
+            "participant": {
+              "primaryKey": "pcampbell",
+              "uid": "pcampbell",
+              "displayname": "Paul Campbell",
+              "type": 0
+            },
+            "cardId": 323,
+            "type": 0
+          }
+        ],
+        "attachments": null,
+        "attachmentCount": 0,
+        "owner": {
+          "primaryKey": "pcampbell",
+          "uid": "pcampbell",
+          "displayname": "Paul Campbell",
+          "type": 0
+        },
+        "order": 1,
+        "archived": false,
+        "done": null,
+        "duedate": null,
+        "deletedAt": 0,
+        "commentsUnread": 0,
+        "commentsCount": 0,
+        "ETag": "3da05f904903c88450b79e4f8f6e2160",
+        "overdue": 0
+      }
+    ],
+    "order": 1,
+    "ETag": "3da05f904903c88450b79e4f8f6e2160"
+  },
+  {
+    "id": 1,
+    "title": "To do",
+    "boardId": 1,
+    "deletedAt": 0,
+    "lastModified": 1733337423,
+    "cards": [
+      {
+        "id": 318,
+        "title": "This",
+        "description": "",
+        "stackId": 1,
+        "type": "plain",
+        "lastModified": 1733049748,
+        "lastEditor": null,
+        "createdAt": 1732610548,
+        "labels": [],
+        "assignedUsers": [],
+        "attachments": null,
+        "attachmentCount": 1,
+        "owner": {
+          "primaryKey": "pcampbell",
+          "uid": "pcampbell",
+          "displayname": "Paul Campbell",
+          "type": 0
+        },
+        "order": 0,
+        "archived": false,
+        "done": null,
+        "duedate": null,
+        "deletedAt": 0,
+        "commentsUnread": 0,
+        "commentsCount": 0,
+        "ETag": "e5007451d88799e3e3d3581cbcb30210",
+        "overdue": 0
+      },
+      {
+        "id": 321,
+        "title": "Breakfast: Cereal",
+        "description": "",
+        "stackId": 1,
+        "type": "plain",
+        "lastModified": 1733337423,
+        "lastEditor": null,
+        "createdAt": 1733043461,
+        "labels": [],
+        "assignedUsers": [
+          {
+            "id": 24,
+            "participant": {
+              "primaryKey": "pcampbell",
+              "uid": "pcampbell",
+              "displayname": "Paul Campbell",
+              "type": 0
+            },
+            "cardId": 321,
+            "type": 0
+          }
+        ],
+        "attachments": null,
+        "attachmentCount": 0,
+        "owner": {
+          "primaryKey": "pcampbell",
+          "uid": "pcampbell",
+          "displayname": "Paul Campbell",
+          "type": 0
+        },
+        "order": 1,
+        "archived": false,
+        "done": null,
+        "duedate": null,
+        "deletedAt": 0,
+        "commentsUnread": 0,
+        "commentsCount": 0,
+        "ETag": "b567d287210fa4d9b108ac68d5b087c1",
+        "overdue": 0
+      }
+    ],
+    "order": 0,
+    "ETag": "b567d287210fa4d9b108ac68d5b087c1"
+  }
+]
\ No newline at end of file