bretton.dev / coves
A community based topic aggregation platform built on atproto
fork atom

Implementation of community banning

Bretton May 246272c8 d49f8579

options
unified split
Changed files
+333
internal
atproto
lexicon
social
coves
moderation
ban.json
banUser.json
getBanStatus.json
listBans.json
unbanUser.json
+76
internal/atproto/lexicon/social/coves/moderation/ban.json 
···

       

       
1

       
+

       
{


     

       

       
2

       
+

       
  "lexicon": 1,


     

       

       
3

       
+

       
  "id": "social.coves.moderation.ban",


     

       

       
4

       
+

       
  "defs": {


     

       

       
5

       
+

       
    "main": {


     

       

       
6

       
+

       
      "type": "record",


     

       

       
7

       
+

       
      "description": "A ban record for a user in a community",


     

       

       
8

       
+

       
      "key": "tid",


     

       

       
9

       
+

       
      "record": {


     

       

       
10

       
+

       
        "type": "object",


     

       

       
11

       
+

       
        "required": ["community", "subject", "banType", "reason", "createdAt"],


     

       

       
12

       
+

       
        "properties": {


     

       

       
13

       
+

       
          "community": {


     

       

       
14

       
+

       
            "type": "string",


     

       

       
15

       
+

       
            "format": "at-uri",


     

       

       
16

       
+

       
            "description": "AT-URI of the community"


     

       

       
17

       
+

       
          },


     

       

       
18

       
+

       
          "subject": {


     

       

       
19

       
+

       
            "type": "string",


     

       

       
20

       
+

       
            "format": "did",


     

       

       
21

       
+

       
            "description": "DID of the banned user"


     

       

       
22

       
+

       
          },


     

       

       
23

       
+

       
          "banType": {


     

       

       
24

       
+

       
            "type": "string",


     

       

       
25

       
+

       
            "knownValues": ["moderator", "tribunal"],


     

       

       
26

       
+

       
            "description": "How the ban was imposed"


     

       

       
27

       
+

       
          },


     

       

       
28

       
+

       
          "reason": {


     

       

       
29

       
+

       
            "type": "string",


     

       

       
30

       
+

       
            "maxLength": 2000,


     

       

       
31

       
+

       
            "description": "Reason for the ban"


     

       

       
32

       
+

       
          },


     

       

       
33

       
+

       
          "duration": {


     

       

       
34

       
+

       
            "type": "integer",


     

       

       
35

       
+

       
            "minimum": 1,


     

       

       
36

       
+

       
            "description": "Ban duration in hours (null for permanent)"


     

       

       
37

       
+

       
          },


     

       

       
38

       
+

       
          "bannedBy": {


     

       

       
39

       
+

       
            "type": "string",


     

       

       
40

       
+

       
            "format": "did",


     

       

       
41

       
+

       
            "description": "DID of moderator who issued ban (null for tribunal bans)"


     

       

       
42

       
+

       
          },


     

       

       
43

       
+

       
          "tribunalCase": {


     

       

       
44

       
+

       
            "type": "string",


     

       

       
45

       
+

       
            "format": "at-uri",


     

       

       
46

       
+

       
            "description": "AT-URI of tribunal case that resulted in ban"


     

       

       
47

       
+

       
          },


     

       

       
48

       
+

       
          "status": {


     

       

       
49

       
+

       
            "type": "string",


     

       

       
50

       
+

       
            "knownValues": ["active", "expired", "revoked"],


     

       

       
51

       
+

       
            "default": "active"


     

       

       
52

       
+

       
          },


     

       

       
53

       
+

       
          "expiresAt": {


     

       

       
54

       
+

       
            "type": "string",


     

       

       
55

       
+

       
            "format": "datetime",


     

       

       
56

       
+

       
            "description": "When the ban expires (null for permanent)"


     

       

       
57

       
+

       
          },


     

       

       
58

       
+

       
          "revokedAt": {


     

       

       
59

       
+

       
            "type": "string",


     

       

       
60

       
+

       
            "format": "datetime",


     

       

       
61

       
+

       
            "description": "When the ban was revoked"


     

       

       
62

       
+

       
          },


     

       

       
63

       
+

       
          "revokedBy": {


     

       

       
64

       
+

       
            "type": "string",


     

       

       
65

       
+

       
            "format": "did",


     

       

       
66

       
+

       
            "description": "DID of moderator who revoked the ban"


     

       

       
67

       
+

       
          },


     

       

       
68

       
+

       
          "createdAt": {


     

       

       
69

       
+

       
            "type": "string",


     

       

       
70

       
+

       
            "format": "datetime"


     

       

       
71

       
+

       
          }


     

       

       
72

       
+

       
        }


     

       

       
73

       
+

       
      }


     

       

       
74

       
+

       
    }


     

       

       
75

       
+

       
  }


     

       

       
76

       
+

       
}
+70
internal/atproto/lexicon/social/coves/moderation/banUser.json 
···

       

       
1

       
+

       
{


     

       

       
2

       
+

       
  "lexicon": 1,


     

       

       
3

       
+

       
  "id": "social.coves.moderation.banUser",


     

       

       
4

       
+

       
  "defs": {


     

       

       
5

       
+

       
    "main": {


     

       

       
6

       
+

       
      "type": "procedure",


     

       

       
7

       
+

       
      "description": "Ban a user from a community (moderator action)",


     

       

       
8

       
+

       
      "input": {


     

       

       
9

       
+

       
        "encoding": "application/json",


     

       

       
10

       
+

       
        "schema": {


     

       

       
11

       
+

       
          "type": "object",


     

       

       
12

       
+

       
          "required": ["community", "subject", "reason"],


     

       

       
13

       
+

       
          "properties": {


     

       

       
14

       
+

       
            "community": {


     

       

       
15

       
+

       
              "type": "string",


     

       

       
16

       
+

       
              "format": "at-uri",


     

       

       
17

       
+

       
              "description": "AT-URI of the community"


     

       

       
18

       
+

       
            },


     

       

       
19

       
+

       
            "subject": {


     

       

       
20

       
+

       
              "type": "string",


     

       

       
21

       
+

       
              "format": "did",


     

       

       
22

       
+

       
              "description": "DID of the user to ban"


     

       

       
23

       
+

       
            },


     

       

       
24

       
+

       
            "reason": {


     

       

       
25

       
+

       
              "type": "string",


     

       

       
26

       
+

       
              "maxLength": 2000,


     

       

       
27

       
+

       
              "description": "Reason for the ban"


     

       

       
28

       
+

       
            },


     

       

       
29

       
+

       
            "duration": {


     

       

       
30

       
+

       
              "type": "integer",


     

       

       
31

       
+

       
              "minimum": 1,


     

       

       
32

       
+

       
              "description": "Ban duration in hours (omit for permanent)"


     

       

       
33

       
+

       
            }


     

       

       
34

       
+

       
          }


     

       

       
35

       
+

       
        }


     

       

       
36

       
+

       
      },


     

       

       
37

       
+

       
      "output": {


     

       

       
38

       
+

       
        "encoding": "application/json",


     

       

       
39

       
+

       
        "schema": {


     

       

       
40

       
+

       
          "type": "object",


     

       

       
41

       
+

       
          "required": ["ban"],


     

       

       
42

       
+

       
          "properties": {


     

       

       
43

       
+

       
            "ban": {


     

       

       
44

       
+

       
              "type": "ref",


     

       

       
45

       
+

       
              "ref": "social.coves.moderation.ban"


     

       

       
46

       
+

       
            }


     

       

       
47

       
+

       
          }


     

       

       
48

       
+

       
        }


     

       

       
49

       
+

       
      },


     

       

       
50

       
+

       
      "errors": [


     

       

       
51

       
+

       
        {


     

       

       
52

       
+

       
          "name": "NotAuthorized",


     

       

       
53

       
+

       
          "description": "User is not authorized to ban users in this community"


     

       

       
54

       
+

       
        },


     

       

       
55

       
+

       
        {


     

       

       
56

       
+

       
          "name": "UserNotFound",


     

       

       
57

       
+

       
          "description": "Target user does not exist"


     

       

       
58

       
+

       
        },


     

       

       
59

       
+

       
        {


     

       

       
60

       
+

       
          "name": "CommunityNotFound",


     

       

       
61

       
+

       
          "description": "Community does not exist"


     

       

       
62

       
+

       
        },


     

       

       
63

       
+

       
        {


     

       

       
64

       
+

       
          "name": "AlreadyBanned",


     

       

       
65

       
+

       
          "description": "User is already banned from this community"


     

       

       
66

       
+

       
        }


     

       

       
67

       
+

       
      ]


     

       

       
68

       
+

       
    }


     

       

       
69

       
+

       
  }


     

       

       
70

       
+

       
}
+54
internal/atproto/lexicon/social/coves/moderation/getBanStatus.json 
···

       

       
1

       
+

       
{


     

       

       
2

       
+

       
  "lexicon": 1,


     

       

       
3

       
+

       
  "id": "social.coves.moderation.getBanStatus",


     

       

       
4

       
+

       
  "defs": {


     

       

       
5

       
+

       
    "main": {


     

       

       
6

       
+

       
      "type": "query",


     

       

       
7

       
+

       
      "description": "Check if a user is banned from a community",


     

       

       
8

       
+

       
      "parameters": {


     

       

       
9

       
+

       
        "type": "params",


     

       

       
10

       
+

       
        "required": ["community", "subject"],


     

       

       
11

       
+

       
        "properties": {


     

       

       
12

       
+

       
          "community": {


     

       

       
13

       
+

       
            "type": "string",


     

       

       
14

       
+

       
            "format": "at-uri",


     

       

       
15

       
+

       
            "description": "AT-URI of the community"


     

       

       
16

       
+

       
          },


     

       

       
17

       
+

       
          "subject": {


     

       

       
18

       
+

       
            "type": "string",


     

       

       
19

       
+

       
            "format": "did",


     

       

       
20

       
+

       
            "description": "DID of the user to check"


     

       

       
21

       
+

       
          }


     

       

       
22

       
+

       
        }


     

       

       
23

       
+

       
      },


     

       

       
24

       
+

       
      "output": {


     

       

       
25

       
+

       
        "encoding": "application/json",


     

       

       
26

       
+

       
        "schema": {


     

       

       
27

       
+

       
          "type": "object",


     

       

       
28

       
+

       
          "required": ["isBanned"],


     

       

       
29

       
+

       
          "properties": {


     

       

       
30

       
+

       
            "isBanned": {


     

       

       
31

       
+

       
              "type": "boolean",


     

       

       
32

       
+

       
              "description": "Whether the user is currently banned"


     

       

       
33

       
+

       
            },


     

       

       
34

       
+

       
            "ban": {


     

       

       
35

       
+

       
              "type": "ref",


     

       

       
36

       
+

       
              "ref": "social.coves.moderation.ban",


     

       

       
37

       
+

       
              "description": "Ban record if user is banned"


     

       

       
38

       
+

       
            }


     

       

       
39

       
+

       
          }


     

       

       
40

       
+

       
        }


     

       

       
41

       
+

       
      },


     

       

       
42

       
+

       
      "errors": [


     

       

       
43

       
+

       
        {


     

       

       
44

       
+

       
          "name": "CommunityNotFound",


     

       

       
45

       
+

       
          "description": "Community does not exist"


     

       

       
46

       
+

       
        },


     

       

       
47

       
+

       
        {


     

       

       
48

       
+

       
          "name": "UserNotFound",


     

       

       
49

       
+

       
          "description": "User does not exist"


     

       

       
50

       
+

       
        }


     

       

       
51

       
+

       
      ]


     

       

       
52

       
+

       
    }


     

       

       
53

       
+

       
  }


     

       

       
54

       
+

       
}
+68
internal/atproto/lexicon/social/coves/moderation/listBans.json 
···

       

       
1

       
+

       
{


     

       

       
2

       
+

       
  "lexicon": 1,


     

       

       
3

       
+

       
  "id": "social.coves.moderation.listBans",


     

       

       
4

       
+

       
  "defs": {


     

       

       
5

       
+

       
    "main": {


     

       

       
6

       
+

       
      "type": "query",


     

       

       
7

       
+

       
      "description": "List bans for a community (moderator only)",


     

       

       
8

       
+

       
      "parameters": {


     

       

       
9

       
+

       
        "type": "params",


     

       

       
10

       
+

       
        "required": ["community"],


     

       

       
11

       
+

       
        "properties": {


     

       

       
12

       
+

       
          "community": {


     

       

       
13

       
+

       
            "type": "string",


     

       

       
14

       
+

       
            "format": "at-uri",


     

       

       
15

       
+

       
            "description": "AT-URI of the community"


     

       

       
16

       
+

       
          },


     

       

       
17

       
+

       
          "status": {


     

       

       
18

       
+

       
            "type": "string",


     

       

       
19

       
+

       
            "knownValues": ["active", "expired", "revoked", "all"],


     

       

       
20

       
+

       
            "default": "active",


     

       

       
21

       
+

       
            "description": "Filter by ban status"


     

       

       
22

       
+

       
          },


     

       

       
23

       
+

       
          "limit": {


     

       

       
24

       
+

       
            "type": "integer",


     

       

       
25

       
+

       
            "minimum": 1,


     

       

       
26

       
+

       
            "maximum": 100,


     

       

       
27

       
+

       
            "default": 50,


     

       

       
28

       
+

       
            "description": "Maximum number of bans to return"


     

       

       
29

       
+

       
          },


     

       

       
30

       
+

       
          "cursor": {


     

       

       
31

       
+

       
            "type": "string",


     

       

       
32

       
+

       
            "description": "Pagination cursor"


     

       

       
33

       
+

       
          }


     

       

       
34

       
+

       
        }


     

       

       
35

       
+

       
      },


     

       

       
36

       
+

       
      "output": {


     

       

       
37

       
+

       
        "encoding": "application/json",


     

       

       
38

       
+

       
        "schema": {


     

       

       
39

       
+

       
          "type": "object",


     

       

       
40

       
+

       
          "required": ["bans"],


     

       

       
41

       
+

       
          "properties": {


     

       

       
42

       
+

       
            "bans": {


     

       

       
43

       
+

       
              "type": "array",


     

       

       
44

       
+

       
              "items": {


     

       

       
45

       
+

       
                "type": "ref",


     

       

       
46

       
+

       
                "ref": "social.coves.moderation.ban"


     

       

       
47

       
+

       
              }


     

       

       
48

       
+

       
            },


     

       

       
49

       
+

       
            "cursor": {


     

       

       
50

       
+

       
              "type": "string",


     

       

       
51

       
+

       
              "description": "Pagination cursor for next page"


     

       

       
52

       
+

       
            }


     

       

       
53

       
+

       
          }


     

       

       
54

       
+

       
        }


     

       

       
55

       
+

       
      },


     

       

       
56

       
+

       
      "errors": [


     

       

       
57

       
+

       
        {


     

       

       
58

       
+

       
          "name": "NotAuthorized",


     

       

       
59

       
+

       
          "description": "User is not authorized to view bans for this community"


     

       

       
60

       
+

       
        },


     

       

       
61

       
+

       
        {


     

       

       
62

       
+

       
          "name": "CommunityNotFound",


     

       

       
63

       
+

       
          "description": "Community does not exist"


     

       

       
64

       
+

       
        }


     

       

       
65

       
+

       
      ]


     

       

       
66

       
+

       
    }


     

       

       
67

       
+

       
  }


     

       

       
68

       
+

       
}
+65
internal/atproto/lexicon/social/coves/moderation/unbanUser.json 
···

       

       
1

       
+

       
{


     

       

       
2

       
+

       
  "lexicon": 1,


     

       

       
3

       
+

       
  "id": "social.coves.moderation.unbanUser",


     

       

       
4

       
+

       
  "defs": {


     

       

       
5

       
+

       
    "main": {


     

       

       
6

       
+

       
      "type": "procedure",


     

       

       
7

       
+

       
      "description": "Unban a user from a community (moderator action)",


     

       

       
8

       
+

       
      "input": {


     

       

       
9

       
+

       
        "encoding": "application/json",


     

       

       
10

       
+

       
        "schema": {


     

       

       
11

       
+

       
          "type": "object",


     

       

       
12

       
+

       
          "required": ["community", "subject"],


     

       

       
13

       
+

       
          "properties": {


     

       

       
14

       
+

       
            "community": {


     

       

       
15

       
+

       
              "type": "string",


     

       

       
16

       
+

       
              "format": "at-uri",


     

       

       
17

       
+

       
              "description": "AT-URI of the community"


     

       

       
18

       
+

       
            },


     

       

       
19

       
+

       
            "subject": {


     

       

       
20

       
+

       
              "type": "string",


     

       

       
21

       
+

       
              "format": "did",


     

       

       
22

       
+

       
              "description": "DID of the user to unban"


     

       

       
23

       
+

       
            },


     

       

       
24

       
+

       
            "reason": {


     

       

       
25

       
+

       
              "type": "string",


     

       

       
26

       
+

       
              "maxLength": 1000,


     

       

       
27

       
+

       
              "description": "Reason for unbanning (optional)"


     

       

       
28

       
+

       
            }


     

       

       
29

       
+

       
          }


     

       

       
30

       
+

       
        }


     

       

       
31

       
+

       
      },


     

       

       
32

       
+

       
      "output": {


     

       

       
33

       
+

       
        "encoding": "application/json",


     

       

       
34

       
+

       
        "schema": {


     

       

       
35

       
+

       
          "type": "object",


     

       

       
36

       
+

       
          "required": ["success"],


     

       

       
37

       
+

       
          "properties": {


     

       

       
38

       
+

       
            "success": {


     

       

       
39

       
+

       
              "type": "boolean",


     

       

       
40

       
+

       
              "description": "Whether the unban was successful"


     

       

       
41

       
+

       
            }


     

       

       
42

       
+

       
          }


     

       

       
43

       
+

       
        }


     

       

       
44

       
+

       
      },


     

       

       
45

       
+

       
      "errors": [


     

       

       
46

       
+

       
        {


     

       

       
47

       
+

       
          "name": "NotAuthorized",


     

       

       
48

       
+

       
          "description": "User is not authorized to unban users in this community"


     

       

       
49

       
+

       
        },


     

       

       
50

       
+

       
        {


     

       

       
51

       
+

       
          "name": "UserNotFound",


     

       

       
52

       
+

       
          "description": "Target user does not exist"


     

       

       
53

       
+

       
        },


     

       

       
54

       
+

       
        {


     

       

       
55

       
+

       
          "name": "CommunityNotFound",


     

       

       
56

       
+

       
          "description": "Community does not exist"


     

       

       
57

       
+

       
        },


     

       

       
58

       
+

       
        {


     

       

       
59

       
+

       
          "name": "NotBanned",


     

       

       
60

       
+

       
          "description": "User is not currently banned from this community"


     

       

       
61

       
+

       
        }


     

       

       
62

       
+

       
      ]


     

       

       
63

       
+

       
    }


     

       

       
64

       
+

       
  }


     

       

       
65

       
+

       
}