A community based topic aggregation platform built on atproto
bretton.dev
1package communities
2
3import (
4 "time"
5)
6
7// Community represents a Coves community indexed from the firehose
8// Communities are federated, instance-scoped forums built on atProto
9type Community struct {
10 CreatedAt time.Time `json:"createdAt" db:"created_at"`
11 UpdatedAt time.Time `json:"updatedAt" db:"updated_at"`
12 RecordURI string `json:"recordUri,omitempty" db:"record_uri"`
13 FederatedFrom string `json:"federatedFrom,omitempty" db:"federated_from"`
14 DisplayName string `json:"displayName" db:"display_name"`
15 Description string `json:"description" db:"description"`
16 PDSURL string `json:"-" db:"pds_url"`
17 AvatarCID string `json:"avatarCid,omitempty" db:"avatar_cid"`
18 BannerCID string `json:"bannerCid,omitempty" db:"banner_cid"`
19 OwnerDID string `json:"ownerDid" db:"owner_did"`
20 CreatedByDID string `json:"createdByDid" db:"created_by_did"`
21 HostedByDID string `json:"hostedByDid" db:"hosted_by_did"`
22 PDSEmail string `json:"-" db:"pds_email"`
23 PDSPassword string `json:"-" db:"pds_password_encrypted"`
24 Name string `json:"name" db:"name"`
25 RecordCID string `json:"recordCid,omitempty" db:"record_cid"`
26 FederatedID string `json:"federatedId,omitempty" db:"federated_id"`
27 PDSAccessToken string `json:"-" db:"pds_access_token"`
28 SigningKeyPEM string `json:"-" db:"signing_key_encrypted"`
29 ModerationType string `json:"moderationType,omitempty" db:"moderation_type"`
30 Handle string `json:"handle" db:"handle"`
31 PDSRefreshToken string `json:"-" db:"pds_refresh_token"`
32 Visibility string `json:"visibility" db:"visibility"`
33 RotationKeyPEM string `json:"-" db:"rotation_key_encrypted"`
34 DID string `json:"did" db:"did"`
35 ContentWarnings []string `json:"contentWarnings,omitempty" db:"content_warnings"`
36 DescriptionFacets []byte `json:"descriptionFacets,omitempty" db:"description_facets"`
37 PostCount int `json:"postCount" db:"post_count"`
38 SubscriberCount int `json:"subscriberCount" db:"subscriber_count"`
39 MemberCount int `json:"memberCount" db:"member_count"`
40 ID int `json:"id" db:"id"`
41 AllowExternalDiscovery bool `json:"allowExternalDiscovery" db:"allow_external_discovery"`
42}
43
44// Subscription represents a lightweight feed follow (user subscribes to see posts)
45type Subscription struct {
46 SubscribedAt time.Time `json:"subscribedAt" db:"subscribed_at"`
47 UserDID string `json:"userDid" db:"user_did"`
48 CommunityDID string `json:"communityDid" db:"community_did"`
49 RecordURI string `json:"recordUri,omitempty" db:"record_uri"`
50 RecordCID string `json:"recordCid,omitempty" db:"record_cid"`
51 ContentVisibility int `json:"contentVisibility" db:"content_visibility"` // Feed slider: 1-5 (1=best content only, 5=all content)
52 ID int `json:"id" db:"id"`
53}
54
55// Membership represents active participation with reputation tracking
56type Membership struct {
57 JoinedAt time.Time `json:"joinedAt" db:"joined_at"`
58 LastActiveAt time.Time `json:"lastActiveAt" db:"last_active_at"`
59 UserDID string `json:"userDid" db:"user_did"`
60 CommunityDID string `json:"communityDid" db:"community_did"`
61 ID int `json:"id" db:"id"`
62 ReputationScore int `json:"reputationScore" db:"reputation_score"`
63 ContributionCount int `json:"contributionCount" db:"contribution_count"`
64 IsBanned bool `json:"isBanned" db:"is_banned"`
65 IsModerator bool `json:"isModerator" db:"is_moderator"`
66}
67
68// ModerationAction represents a moderation action taken against a community
69type ModerationAction struct {
70 CreatedAt time.Time `json:"createdAt" db:"created_at"`
71 ExpiresAt *time.Time `json:"expiresAt,omitempty" db:"expires_at"`
72 CommunityDID string `json:"communityDid" db:"community_did"`
73 Action string `json:"action" db:"action"`
74 Reason string `json:"reason,omitempty" db:"reason"`
75 InstanceDID string `json:"instanceDid" db:"instance_did"`
76 ID int `json:"id" db:"id"`
77 Broadcast bool `json:"broadcast" db:"broadcast"`
78}
79
80// CreateCommunityRequest represents input for creating a new community
81type CreateCommunityRequest struct {
82 Name string `json:"name"`
83 DisplayName string `json:"displayName,omitempty"`
84 Description string `json:"description"`
85 Language string `json:"language,omitempty"`
86 Visibility string `json:"visibility"`
87 CreatedByDID string `json:"createdByDid"`
88 HostedByDID string `json:"hostedByDid"`
89 AvatarBlob []byte `json:"avatarBlob,omitempty"`
90 BannerBlob []byte `json:"bannerBlob,omitempty"`
91 Rules []string `json:"rules,omitempty"`
92 Categories []string `json:"categories,omitempty"`
93 AllowExternalDiscovery bool `json:"allowExternalDiscovery"`
94}
95
96// UpdateCommunityRequest represents input for updating community metadata
97type UpdateCommunityRequest struct {
98 CommunityDID string `json:"communityDid"`
99 UpdatedByDID string `json:"updatedByDid"` // User making the update (for authorization)
100 DisplayName *string `json:"displayName,omitempty"`
101 Description *string `json:"description,omitempty"`
102 AvatarBlob []byte `json:"avatarBlob,omitempty"`
103 BannerBlob []byte `json:"bannerBlob,omitempty"`
104 Visibility *string `json:"visibility,omitempty"`
105 AllowExternalDiscovery *bool `json:"allowExternalDiscovery,omitempty"`
106 ModerationType *string `json:"moderationType,omitempty"`
107 ContentWarnings []string `json:"contentWarnings,omitempty"`
108}
109
110// ListCommunitiesRequest represents query parameters for listing communities
111type ListCommunitiesRequest struct {
112 Visibility string `json:"visibility,omitempty"`
113 HostedBy string `json:"hostedBy,omitempty"`
114 SortBy string `json:"sortBy,omitempty"`
115 SortOrder string `json:"sortOrder,omitempty"`
116 Limit int `json:"limit"`
117 Offset int `json:"offset"`
118}
119
120// SearchCommunitiesRequest represents query parameters for searching communities
121type SearchCommunitiesRequest struct {
122 Query string `json:"query"`
123 Visibility string `json:"visibility,omitempty"`
124 Limit int `json:"limit"`
125 Offset int `json:"offset"`
126}