commit 81b515b729b4167c0bf530a7e24c30c13a3df8a7 · bretton.dev/coves

go.mod

···

       72
       72
        
       	github.com/sethvargo/go-retry v0.3.0 // indirect

     

       73
       73
        
       	github.com/spaolacci/murmur3 v1.1.0 // indirect

     

       74
       74
        
       	github.com/whyrusleeping/cbor-gen v0.2.1-0.20241030202151-b7a6831be65e // indirect

     

       75
       75
       +
       	github.com/xeipuuv/gojsonpointer v0.0.0-20180127040702-4e3ac2762d5f // indirect

     

       76
       76
       +
       	github.com/xeipuuv/gojsonreference v0.0.0-20180127040603-bd5ef7bd5415 // indirect

     

       77
       77
       +
       	github.com/xeipuuv/gojsonschema v1.2.0 // indirect

     

       75
       78
        
       	gitlab.com/yawning/secp256k1-voi v0.0.0-20230925100816-f2616030848b // indirect

     

       76
       79
        
       	gitlab.com/yawning/tuplehash v0.0.0-20230713102510-df83abbf9a02 // indirect

     

       77
       80
        
       	go.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.46.1 // indirect

go.sum

···

       187
       187
        
       github.com/warpfork/go-wish v0.0.0-20220906213052-39a1cc7a02d0/go.mod h1:x6AKhvSSexNrVSrViXSHUEbICjmGXhtgABaHIySUSGw=

     

       188
       188
        
       github.com/whyrusleeping/cbor-gen v0.2.1-0.20241030202151-b7a6831be65e h1:28X54ciEwwUxyHn9yrZfl5ojgF4CBNLWX7LR0rvBkf4=

     

       189
       189
        
       github.com/whyrusleeping/cbor-gen v0.2.1-0.20241030202151-b7a6831be65e/go.mod h1:pM99HXyEbSQHcosHc0iW7YFmwnscr+t9Te4ibko05so=

     

       190
       190
       +
       github.com/xeipuuv/gojsonpointer v0.0.0-20180127040702-4e3ac2762d5f h1:J9EGpcZtP0E/raorCMxlFGSTBrsSlaDGf3jU/qvAE2c=

     

       191
       191
       +
       github.com/xeipuuv/gojsonpointer v0.0.0-20180127040702-4e3ac2762d5f/go.mod h1:N2zxlSyiKSe5eX1tZViRH5QA0qijqEDrYZiPEAiq3wU=

     

       192
       192
       +
       github.com/xeipuuv/gojsonreference v0.0.0-20180127040603-bd5ef7bd5415 h1:EzJWgHovont7NscjpAxXsDA8S8BMYve8Y5+7cuRE7R0=

     

       193
       193
       +
       github.com/xeipuuv/gojsonreference v0.0.0-20180127040603-bd5ef7bd5415/go.mod h1:GwrjFmJcFw6At/Gs6z4yjiIwzuJ1/+UwLxMQDVQXShQ=

     

       194
       194
       +
       github.com/xeipuuv/gojsonschema v1.2.0 h1:LhYJRs+L4fBtjZUfuSZIKGeVu0QRy8e5Xi7D17UxZ74=

     

       195
       195
       +
       github.com/xeipuuv/gojsonschema v1.2.0/go.mod h1:anYRn/JVcOK2ZgGU+IjEV4nwlhoK5sQluxsYJ78Id3Y=

     

       190
       196
        
       github.com/yuin/goldmark v1.1.27/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=

     

       191
       197
        
       github.com/yuin/goldmark v1.2.1/go.mod h1:3hX8gzYuyVAZsxl0MRgGTJEmQBFcNTphYh9decYSb74=

     

       192
       198
        
       github.com/yuin/goldmark v1.3.5/go.mod h1:mwnBkeHKe2W/ZEtQ+71ViKU8L12m81fl3OWwC1Zlc8k=

+97

internal/core/aggregators/aggregator.go

···

       1
       1
       +
       package aggregators

     

       2
       2
       +
       

     

       3
       3
       +
       import "time"

     

       4
       4
       +
       

     

       5
       5
       +
       // Aggregator represents a service declaration record indexed from the firehose

     

       6
       6
       +
       // Aggregators are autonomous services that can post content to communities after authorization

     

       7
       7
       +
       // Following Bluesky's pattern: app.bsky.feed.generator and app.bsky.labeler.service

     

       8
       8
       +
       type Aggregator struct {

     

       9
       9
       +
       	DID              string    `json:"did" db:"did"`                               // Aggregator's DID (primary key)

     

       10
       10
       +
       	DisplayName      string    `json:"displayName" db:"display_name"`              // Human-readable name

     

       11
       11
       +
       	Description      string    `json:"description,omitempty" db:"description"`     // What the aggregator does

     

       12
       12
       +
       	AvatarURL        string    `json:"avatarUrl,omitempty" db:"avatar_url"`        // Optional avatar image URL

     

       13
       13
       +
       	ConfigSchema     []byte    `json:"configSchema,omitempty" db:"config_schema"`  // JSON Schema for configuration (JSONB)

     

       14
       14
       +
       	MaintainerDID    string    `json:"maintainerDid,omitempty" db:"maintainer_did"` // Contact for support/issues

     

       15
       15
       +
       	SourceURL        string    `json:"sourceUrl,omitempty" db:"source_url"`        // Source code URL (transparency)

     

       16
       16
       +
       	CommunitiesUsing int       `json:"communitiesUsing" db:"communities_using"`    // Auto-updated by trigger

     

       17
       17
       +
       	PostsCreated     int       `json:"postsCreated" db:"posts_created"`            // Auto-updated by trigger

     

       18
       18
       +
       	CreatedAt        time.Time `json:"createdAt" db:"created_at"`                  // When aggregator was created (from lexicon)

     

       19
       19
       +
       	IndexedAt        time.Time `json:"indexedAt" db:"indexed_at"`                  // When we indexed this record

     

       20
       20
       +
       	RecordURI        string    `json:"recordUri,omitempty" db:"record_uri"`        // at://did/social.coves.aggregator.service/self

     

       21
       21
       +
       	RecordCID        string    `json:"recordCid,omitempty" db:"record_cid"`        // Content hash

     

       22
       22
       +
       }

     

       23
       23
       +
       

     

       24
       24
       +
       // Authorization represents a community's authorization for an aggregator

     

       25
       25
       +
       // Stored in community's repository: at://community_did/social.coves.aggregator.authorization/{rkey}

     

       26
       26
       +
       type Authorization struct {

     

       27
       27
       +
       	ID            int        `json:"id" db:"id"`                                 // Database ID

     

       28
       28
       +
       	AggregatorDID string     `json:"aggregatorDid" db:"aggregator_did"`          // Which aggregator

     

       29
       29
       +
       	CommunityDID  string     `json:"communityDid" db:"community_did"`            // Which community

     

       30
       30
       +
       	Enabled       bool       `json:"enabled" db:"enabled"`                       // Current status

     

       31
       31
       +
       	Config        []byte     `json:"config,omitempty" db:"config"`               // Aggregator-specific config (JSONB)

     

       32
       32
       +
       	CreatedBy     string     `json:"createdBy,omitempty" db:"created_by"`        // Moderator DID who enabled it

     

       33
       33
       +
       	DisabledBy    string     `json:"disabledBy,omitempty" db:"disabled_by"`      // Moderator DID who disabled it

     

       34
       34
       +
       	CreatedAt     time.Time  `json:"createdAt" db:"created_at"`                  // When authorization was created

     

       35
       35
       +
       	DisabledAt    *time.Time `json:"disabledAt,omitempty" db:"disabled_at"`      // When authorization was disabled (for modlog/audit)

     

       36
       36
       +
       	IndexedAt     time.Time  `json:"indexedAt" db:"indexed_at"`                  // When we indexed this record

     

       37
       37
       +
       	RecordURI     string     `json:"recordUri,omitempty" db:"record_uri"`        // at://community_did/social.coves.aggregator.authorization/{rkey}

     

       38
       38
       +
       	RecordCID     string     `json:"recordCid,omitempty" db:"record_cid"`        // Content hash

     

       39
       39
       +
       }

     

       40
       40
       +
       

     

       41
       41
       +
       // AggregatorPost represents tracking of posts created by aggregators

     

       42
       42
       +
       // AppView-only table for rate limiting and statistics

     

       43
       43
       +
       type AggregatorPost struct {

     

       44
       44
       +
       	ID            int       `json:"id" db:"id"`

     

       45
       45
       +
       	AggregatorDID string    `json:"aggregatorDid" db:"aggregator_did"`

     

       46
       46
       +
       	CommunityDID  string    `json:"communityDid" db:"community_did"`

     

       47
       47
       +
       	PostURI       string    `json:"postUri" db:"post_uri"`

     

       48
       48
       +
       	PostCID       string    `json:"postCid" db:"post_cid"`

     

       49
       49
       +
       	CreatedAt     time.Time `json:"createdAt" db:"created_at"`

     

       50
       50
       +
       }

     

       51
       51
       +
       

     

       52
       52
       +
       // EnableAggregatorRequest represents input for enabling an aggregator in a community

     

       53
       53
       +
       type EnableAggregatorRequest struct {

     

       54
       54
       +
       	CommunityDID   string                 `json:"communityDid"`             // Which community (resolved from identifier)

     

       55
       55
       +
       	AggregatorDID  string                 `json:"aggregatorDid"`            // Which aggregator

     

       56
       56
       +
       	Config         map[string]interface{} `json:"config,omitempty"`         // Aggregator-specific configuration

     

       57
       57
       +
       	EnabledByDID   string                 `json:"enabledByDid"`             // Moderator making the change (from JWT)

     

       58
       58
       +
       	EnabledByToken string                 `json:"-"`                        // User's access token for PDS write

     

       59
       59
       +
       }

     

       60
       60
       +
       

     

       61
       61
       +
       // DisableAggregatorRequest represents input for disabling an aggregator

     

       62
       62
       +
       type DisableAggregatorRequest struct {

     

       63
       63
       +
       	CommunityDID   string `json:"communityDid"`   // Which community (resolved from identifier)

     

       64
       64
       +
       	AggregatorDID  string `json:"aggregatorDid"`  // Which aggregator

     

       65
       65
       +
       	DisabledByDID  string `json:"disabledByDid"`  // Moderator making the change (from JWT)

     

       66
       66
       +
       	DisabledByToken string `json:"-"`             // User's access token for PDS write

     

       67
       67
       +
       }

     

       68
       68
       +
       

     

       69
       69
       +
       // UpdateConfigRequest represents input for updating an aggregator's configuration

     

       70
       70
       +
       type UpdateConfigRequest struct {

     

       71
       71
       +
       	CommunityDID   string                 `json:"communityDid"`             // Which community (resolved from identifier)

     

       72
       72
       +
       	AggregatorDID  string                 `json:"aggregatorDid"`            // Which aggregator

     

       73
       73
       +
       	Config         map[string]interface{} `json:"config"`                   // New configuration

     

       74
       74
       +
       	UpdatedByDID   string                 `json:"updatedByDid"`             // Moderator making the change (from JWT)

     

       75
       75
       +
       	UpdatedByToken string                 `json:"-"`                        // User's access token for PDS write

     

       76
       76
       +
       }

     

       77
       77
       +
       

     

       78
       78
       +
       // GetServicesRequest represents query parameters for fetching aggregator details

     

       79
       79
       +
       type GetServicesRequest struct {

     

       80
       80
       +
       	DIDs []string `json:"dids"` // List of aggregator DIDs to fetch

     

       81
       81
       +
       }

     

       82
       82
       +
       

     

       83
       83
       +
       // GetAuthorizationsRequest represents query parameters for listing authorizations

     

       84
       84
       +
       type GetAuthorizationsRequest struct {

     

       85
       85
       +
       	AggregatorDID string `json:"aggregatorDid"`         // Which aggregator

     

       86
       86
       +
       	EnabledOnly   bool   `json:"enabledOnly,omitempty"` // Only return enabled authorizations

     

       87
       87
       +
       	Limit         int    `json:"limit"`

     

       88
       88
       +
       	Offset        int    `json:"offset"`

     

       89
       89
       +
       }

     

       90
       90
       +
       

     

       91
       91
       +
       // ListForCommunityRequest represents query parameters for listing aggregators for a community

     

       92
       92
       +
       type ListForCommunityRequest struct {

     

       93
       93
       +
       	CommunityDID string `json:"communityDid"`          // Which community (resolved from identifier)

     

       94
       94
       +
       	EnabledOnly  bool   `json:"enabledOnly,omitempty"` // Only return enabled aggregators

     

       95
       95
       +
       	Limit        int    `json:"limit"`

     

       96
       96
       +
       	Offset       int    `json:"offset"`

     

       97
       97
       +
       }

+63

internal/core/aggregators/errors.go

···

       1
       1
       +
       package aggregators

     

       2
       2
       +
       

     

       3
       3
       +
       import (

     

       4
       4
       +
       	"errors"

     

       5
       5
       +
       	"fmt"

     

       6
       6
       +
       )

     

       7
       7
       +
       

     

       8
       8
       +
       // Domain errors

     

       9
       9
       +
       var (

     

       10
       10
       +
       	ErrAggregatorNotFound      = errors.New("aggregator not found")

     

       11
       11
       +
       	ErrAuthorizationNotFound   = errors.New("authorization not found")

     

       12
       12
       +
       	ErrNotAuthorized           = errors.New("aggregator not authorized for this community")

     

       13
       13
       +
       	ErrAlreadyAuthorized       = errors.New("aggregator already authorized for this community")

     

       14
       14
       +
       	ErrRateLimitExceeded       = errors.New("aggregator rate limit exceeded")

     

       15
       15
       +
       	ErrInvalidConfig           = errors.New("invalid aggregator configuration")

     

       16
       16
       +
       	ErrConfigSchemaValidation  = errors.New("configuration does not match aggregator's schema")

     

       17
       17
       +
       	ErrNotModerator            = errors.New("user is not a moderator of this community")

     

       18
       18
       +
       	ErrNotImplemented          = errors.New("feature not yet implemented") // For Phase 2 write-forward operations

     

       19
       19
       +
       )

     

       20
       20
       +
       

     

       21
       21
       +
       // ValidationError represents a validation error with field details

     

       22
       22
       +
       type ValidationError struct {

     

       23
       23
       +
       	Field   string

     

       24
       24
       +
       	Message string

     

       25
       25
       +
       }

     

       26
       26
       +
       

     

       27
       27
       +
       func (e *ValidationError) Error() string {

     

       28
       28
       +
       	return fmt.Sprintf("validation error: %s - %s", e.Field, e.Message)

     

       29
       29
       +
       }

     

       30
       30
       +
       

     

       31
       31
       +
       // NewValidationError creates a new validation error

     

       32
       32
       +
       func NewValidationError(field, message string) error {

     

       33
       33
       +
       	return &ValidationError{

     

       34
       34
       +
       		Field:   field,

     

       35
       35
       +
       		Message: message,

     

       36
       36
       +
       	}

     

       37
       37
       +
       }

     

       38
       38
       +
       

     

       39
       39
       +
       // Error classification helpers for handlers to map to HTTP status codes

     

       40
       40
       +
       func IsNotFound(err error) bool {

     

       41
       41
       +
       	return errors.Is(err, ErrAggregatorNotFound) || errors.Is(err, ErrAuthorizationNotFound)

     

       42
       42
       +
       }

     

       43
       43
       +
       

     

       44
       44
       +
       func IsValidationError(err error) bool {

     

       45
       45
       +
       	var validationErr *ValidationError

     

       46
       46
       +
       	return errors.As(err, &validationErr) || errors.Is(err, ErrInvalidConfig) || errors.Is(err, ErrConfigSchemaValidation)

     

       47
       47
       +
       }

     

       48
       48
       +
       

     

       49
       49
       +
       func IsUnauthorized(err error) bool {

     

       50
       50
       +
       	return errors.Is(err, ErrNotAuthorized) || errors.Is(err, ErrNotModerator)

     

       51
       51
       +
       }

     

       52
       52
       +
       

     

       53
       53
       +
       func IsConflict(err error) bool {

     

       54
       54
       +
       	return errors.Is(err, ErrAlreadyAuthorized)

     

       55
       55
       +
       }

     

       56
       56
       +
       

     

       57
       57
       +
       func IsRateLimited(err error) bool {

     

       58
       58
       +
       	return errors.Is(err, ErrRateLimitExceeded)

     

       59
       59
       +
       }

     

       60
       60
       +
       

     

       61
       61
       +
       func IsNotImplemented(err error) bool {

     

       62
       62
       +
       	return errors.Is(err, ErrNotImplemented)

     

       63
       63
       +
       }

+62

internal/core/aggregators/interfaces.go

···

       1
       1
       +
       package aggregators

     

       2
       2
       +
       

     

       3
       3
       +
       import (

     

       4
       4
       +
       	"context"

     

       5
       5
       +
       	"time"

     

       6
       6
       +
       )

     

       7
       7
       +
       

     

       8
       8
       +
       // Repository defines the interface for aggregator data persistence

     

       9
       9
       +
       // This is the AppView's indexed view of aggregators and authorizations from the firehose

     

       10
       10
       +
       type Repository interface {

     

       11
       11
       +
       	// Aggregator CRUD (indexed from firehose)

     

       12
       12
       +
       	CreateAggregator(ctx context.Context, aggregator *Aggregator) error

     

       13
       13
       +
       	GetAggregator(ctx context.Context, did string) (*Aggregator, error)

     

       14
       14
       +
       	GetAggregatorsByDIDs(ctx context.Context, dids []string) ([]*Aggregator, error) // Bulk fetch to avoid N+1 queries

     

       15
       15
       +
       	UpdateAggregator(ctx context.Context, aggregator *Aggregator) error

     

       16
       16
       +
       	DeleteAggregator(ctx context.Context, did string) error

     

       17
       17
       +
       	ListAggregators(ctx context.Context, limit, offset int) ([]*Aggregator, error)

     

       18
       18
       +
       	IsAggregator(ctx context.Context, did string) (bool, error) // Fast check for post creation handler

     

       19
       19
       +
       

     

       20
       20
       +
       	// Authorization CRUD (indexed from firehose)

     

       21
       21
       +
       	CreateAuthorization(ctx context.Context, auth *Authorization) error

     

       22
       22
       +
       	GetAuthorization(ctx context.Context, aggregatorDID, communityDID string) (*Authorization, error)

     

       23
       23
       +
       	GetAuthorizationByURI(ctx context.Context, recordURI string) (*Authorization, error) // For Jetstream delete operations

     

       24
       24
       +
       	UpdateAuthorization(ctx context.Context, auth *Authorization) error

     

       25
       25
       +
       	DeleteAuthorization(ctx context.Context, aggregatorDID, communityDID string) error

     

       26
       26
       +
       	DeleteAuthorizationByURI(ctx context.Context, recordURI string) error // For Jetstream delete operations

     

       27
       27
       +
       

     

       28
       28
       +
       	// Authorization queries

     

       29
       29
       +
       	ListAuthorizationsForAggregator(ctx context.Context, aggregatorDID string, enabledOnly bool, limit, offset int) ([]*Authorization, error)

     

       30
       30
       +
       	ListAuthorizationsForCommunity(ctx context.Context, communityDID string, enabledOnly bool, limit, offset int) ([]*Authorization, error)

     

       31
       31
       +
       	IsAuthorized(ctx context.Context, aggregatorDID, communityDID string) (bool, error) // Fast check: enabled=true

     

       32
       32
       +
       

     

       33
       33
       +
       	// Post tracking (for rate limiting and stats)

     

       34
       34
       +
       	RecordAggregatorPost(ctx context.Context, aggregatorDID, communityDID, postURI, postCID string) error

     

       35
       35
       +
       	CountRecentPosts(ctx context.Context, aggregatorDID, communityDID string, since time.Time) (int, error)

     

       36
       36
       +
       	GetRecentPosts(ctx context.Context, aggregatorDID, communityDID string, since time.Time) ([]*AggregatorPost, error)

     

       37
       37
       +
       }

     

       38
       38
       +
       

     

       39
       39
       +
       // Service defines the interface for aggregator business logic

     

       40
       40
       +
       // Coordinates between Repository, communities service, and PDS for write-forward

     

       41
       41
       +
       type Service interface {

     

       42
       42
       +
       	// Aggregator queries (read from AppView)

     

       43
       43
       +
       	GetAggregator(ctx context.Context, did string) (*Aggregator, error)

     

       44
       44
       +
       	GetAggregators(ctx context.Context, dids []string) ([]*Aggregator, error)

     

       45
       45
       +
       	ListAggregators(ctx context.Context, limit, offset int) ([]*Aggregator, error)

     

       46
       46
       +
       

     

       47
       47
       +
       	// Authorization queries (read from AppView)

     

       48
       48
       +
       	GetAuthorizationsForAggregator(ctx context.Context, req GetAuthorizationsRequest) ([]*Authorization, error)

     

       49
       49
       +
       	ListAggregatorsForCommunity(ctx context.Context, req ListForCommunityRequest) ([]*Authorization, error)

     

       50
       50
       +
       

     

       51
       51
       +
       	// Authorization management (write-forward: Service -> PDS -> Firehose -> Consumer -> Repository)

     

       52
       52
       +
       	EnableAggregator(ctx context.Context, req EnableAggregatorRequest) (*Authorization, error)

     

       53
       53
       +
       	DisableAggregator(ctx context.Context, req DisableAggregatorRequest) (*Authorization, error)

     

       54
       54
       +
       	UpdateAggregatorConfig(ctx context.Context, req UpdateConfigRequest) (*Authorization, error)

     

       55
       55
       +
       

     

       56
       56
       +
       	// Validation and authorization checks (used by post creation handler)

     

       57
       57
       +
       	ValidateAggregatorPost(ctx context.Context, aggregatorDID, communityDID string) error // Checks authorization + rate limits

     

       58
       58
       +
       	IsAggregator(ctx context.Context, did string) (bool, error) // Check if DID is a registered aggregator

     

       59
       59
       +
       

     

       60
       60
       +
       	// Post tracking (called after successful post creation)

     

       61
       61
       +
       	RecordAggregatorPost(ctx context.Context, aggregatorDID, communityDID, postURI, postCID string) error

     

       62
       62
       +
       }

+360

internal/core/aggregators/service.go

···

       1
       1
       +
       package aggregators

     

       2
       2
       +
       

     

       3
       3
       +
       import (

     

       4
       4
       +
       	"Coves/internal/core/communities"

     

       5
       5
       +
       	"context"

     

       6
       6
       +
       	"encoding/json"

     

       7
       7
       +
       	"fmt"

     

       8
       8
       +
       	"time"

     

       9
       9
       +
       

     

       10
       10
       +
       	"github.com/xeipuuv/gojsonschema"

     

       11
       11
       +
       )

     

       12
       12
       +
       

     

       13
       13
       +
       // Rate limit constants

     

       14
       14
       +
       const (

     

       15
       15
       +
       	RateLimitWindow   = 1 * time.Hour // Rolling 1-hour window for rate limit enforcement

     

       16
       16
       +
       	RateLimitMaxPosts = 10            // Conservative limit for alpha: 10 posts/hour per community (prevents spam while allowing real-time updates)

     

       17
       17
       +
       	DefaultQueryLimit = 50            // Balance between UX (reasonable page size) and server load

     

       18
       18
       +
       	MaxQueryLimit     = 100           // Prevent abuse while allowing batch operations (e.g., fetching multiple aggregators at once)

     

       19
       19
       +
       )

     

       20
       20
       +
       

     

       21
       21
       +
       type aggregatorService struct {

     

       22
       22
       +
       	repo             Repository

     

       23
       23
       +
       	communityService communities.Service

     

       24
       24
       +
       }

     

       25
       25
       +
       

     

       26
       26
       +
       // NewAggregatorService creates a new aggregator service

     

       27
       27
       +
       func NewAggregatorService(repo Repository, communityService communities.Service) Service {

     

       28
       28
       +
       	return &aggregatorService{

     

       29
       29
       +
       		repo:             repo,

     

       30
       30
       +
       		communityService: communityService,

     

       31
       31
       +
       	}

     

       32
       32
       +
       }

     

       33
       33
       +
       

     

       34
       34
       +
       // ===== Query Operations (Read from AppView) =====

     

       35
       35
       +
       

     

       36
       36
       +
       // GetAggregator retrieves a single aggregator by DID

     

       37
       37
       +
       func (s *aggregatorService) GetAggregator(ctx context.Context, did string) (*Aggregator, error) {

     

       38
       38
       +
       	if did == "" {

     

       39
       39
       +
       		return nil, NewValidationError("did", "DID is required")

     

       40
       40
       +
       	}

     

       41
       41
       +
       

     

       42
       42
       +
       	return s.repo.GetAggregator(ctx, did)

     

       43
       43
       +
       }

     

       44
       44
       +
       

     

       45
       45
       +
       // GetAggregators retrieves multiple aggregators by DIDs

     

       46
       46
       +
       func (s *aggregatorService) GetAggregators(ctx context.Context, dids []string) ([]*Aggregator, error) {

     

       47
       47
       +
       	if len(dids) == 0 {

     

       48
       48
       +
       		return []*Aggregator{}, nil

     

       49
       49
       +
       	}

     

       50
       50
       +
       

     

       51
       51
       +
       	if len(dids) > MaxQueryLimit {

     

       52
       52
       +
       		return nil, NewValidationError("dids", fmt.Sprintf("maximum %d DIDs allowed", MaxQueryLimit))

     

       53
       53
       +
       	}

     

       54
       54
       +
       

     

       55
       55
       +
       	// Use bulk fetch to avoid N+1 queries

     

       56
       56
       +
       	return s.repo.GetAggregatorsByDIDs(ctx, dids)

     

       57
       57
       +
       }

     

       58
       58
       +
       

     

       59
       59
       +
       // ListAggregators retrieves all aggregators with pagination

     

       60
       60
       +
       func (s *aggregatorService) ListAggregators(ctx context.Context, limit, offset int) ([]*Aggregator, error) {

     

       61
       61
       +
       	// Apply defaults and limits

     

       62
       62
       +
       	if limit <= 0 {

     

       63
       63
       +
       		limit = DefaultQueryLimit

     

       64
       64
       +
       	}

     

       65
       65
       +
       	if limit > MaxQueryLimit {

     

       66
       66
       +
       		limit = MaxQueryLimit

     

       67
       67
       +
       	}

     

       68
       68
       +
       	if offset < 0 {

     

       69
       69
       +
       		offset = 0

     

       70
       70
       +
       	}

     

       71
       71
       +
       

     

       72
       72
       +
       	return s.repo.ListAggregators(ctx, limit, offset)

     

       73
       73
       +
       }

     

       74
       74
       +
       

     

       75
       75
       +
       // GetAuthorizationsForAggregator retrieves all communities that authorized an aggregator

     

       76
       76
       +
       func (s *aggregatorService) GetAuthorizationsForAggregator(ctx context.Context, req GetAuthorizationsRequest) ([]*Authorization, error) {

     

       77
       77
       +
       	if req.AggregatorDID == "" {

     

       78
       78
       +
       		return nil, NewValidationError("aggregatorDid", "aggregator DID is required")

     

       79
       79
       +
       	}

     

       80
       80
       +
       

     

       81
       81
       +
       	// Apply defaults and limits

     

       82
       82
       +
       	if req.Limit <= 0 {

     

       83
       83
       +
       		req.Limit = DefaultQueryLimit

     

       84
       84
       +
       	}

     

       85
       85
       +
       	if req.Limit > MaxQueryLimit {

     

       86
       86
       +
       		req.Limit = MaxQueryLimit

     

       87
       87
       +
       	}

     

       88
       88
       +
       	if req.Offset < 0 {

     

       89
       89
       +
       		req.Offset = 0

     

       90
       90
       +
       	}

     

       91
       91
       +
       

     

       92
       92
       +
       	return s.repo.ListAuthorizationsForAggregator(ctx, req.AggregatorDID, req.EnabledOnly, req.Limit, req.Offset)

     

       93
       93
       +
       }

     

       94
       94
       +
       

     

       95
       95
       +
       // ListAggregatorsForCommunity retrieves all aggregators authorized by a community

     

       96
       96
       +
       func (s *aggregatorService) ListAggregatorsForCommunity(ctx context.Context, req ListForCommunityRequest) ([]*Authorization, error) {

     

       97
       97
       +
       	if req.CommunityDID == "" {

     

       98
       98
       +
       		return nil, NewValidationError("communityDid", "community DID is required")

     

       99
       99
       +
       	}

     

       100
       100
       +
       

     

       101
       101
       +
       	// Apply defaults and limits

     

       102
       102
       +
       	if req.Limit <= 0 {

     

       103
       103
       +
       		req.Limit = DefaultQueryLimit

     

       104
       104
       +
       	}

     

       105
       105
       +
       	if req.Limit > MaxQueryLimit {

     

       106
       106
       +
       		req.Limit = MaxQueryLimit

     

       107
       107
       +
       	}

     

       108
       108
       +
       	if req.Offset < 0 {

     

       109
       109
       +
       		req.Offset = 0

     

       110
       110
       +
       	}

     

       111
       111
       +
       

     

       112
       112
       +
       	return s.repo.ListAuthorizationsForCommunity(ctx, req.CommunityDID, req.EnabledOnly, req.Limit, req.Offset)

     

       113
       113
       +
       }

     

       114
       114
       +
       

     

       115
       115
       +
       // ===== Authorization Management (Write-forward to PDS) =====

     

       116
       116
       +
       

     

       117
       117
       +
       // EnableAggregator creates an authorization record for an aggregator in a community

     

       118
       118
       +
       // Following Bluesky's pattern: similar to enabling a labeler or feed generator

     

       119
       119
       +
       // Note: This is a PLACEHOLDER for the write-forward implementation

     

       120
       120
       +
       // TODO: Implement actual XRPC write to community's PDS repository

     

       121
       121
       +
       func (s *aggregatorService) EnableAggregator(ctx context.Context, req EnableAggregatorRequest) (*Authorization, error) {

     

       122
       122
       +
       	// Validate request

     

       123
       123
       +
       	if err := s.validateEnableRequest(ctx, req); err != nil {

     

       124
       124
       +
       		return nil, err

     

       125
       125
       +
       	}

     

       126
       126
       +
       

     

       127
       127
       +
       	// Verify aggregator exists

     

       128
       128
       +
       	aggregator, err := s.repo.GetAggregator(ctx, req.AggregatorDID)

     

       129
       129
       +
       	if err != nil {

     

       130
       130
       +
       		return nil, err

     

       131
       131
       +
       	}

     

       132
       132
       +
       

     

       133
       133
       +
       	// Validate config against aggregator's schema if provided

     

       134
       134
       +
       	if len(req.Config) > 0 && len(aggregator.ConfigSchema) > 0 {

     

       135
       135
       +
       		if err := s.validateConfig(req.Config, aggregator.ConfigSchema); err != nil {

     

       136
       136
       +
       			return nil, err

     

       137
       137
       +
       		}

     

       138
       138
       +
       	}

     

       139
       139
       +
       

     

       140
       140
       +
       	// Check if already authorized

     

       141
       141
       +
       	existing, err := s.repo.GetAuthorization(ctx, req.AggregatorDID, req.CommunityDID)

     

       142
       142
       +
       	if err == nil && existing.Enabled {

     

       143
       143
       +
       		return nil, ErrAlreadyAuthorized

     

       144
       144
       +
       	}

     

       145
       145
       +
       

     

       146
       146
       +
       	// TODO Phase 2: Write-forward to PDS

     

       147
       147
       +
       	// For now, return placeholder response

     

       148
       148
       +
       	// The actual implementation will:

     

       149
       149
       +
       	// 1. Create authorization record in community's repository on PDS

     

       150
       150
       +
       	// 2. Wait for Jetstream to index it

     

       151
       151
       +
       	// 3. Return the indexed authorization

     

       152
       152
       +
       	//

     

       153
       153
       +
       	// Record structure:

     

       154
       154
       +
       	// at://community_did/social.coves.aggregator.authorization/{rkey}

     

       155
       155
       +
       	// {

     

       156
       156
       +
       	//   "$type": "social.coves.aggregator.authorization",

     

       157
       157
       +
       	//   "aggregator": req.AggregatorDID,

     

       158
       158
       +
       	//   "enabled": true,

     

       159
       159
       +
       	//   "config": req.Config,

     

       160
       160
       +
       	//   "createdBy": req.EnabledByDID,

     

       161
       161
       +
       	//   "createdAt": "2025-10-20T12:00:00Z"

     

       162
       162
       +
       	// }

     

       163
       163
       +
       

     

       164
       164
       +
       	return nil, ErrNotImplemented

     

       165
       165
       +
       }

     

       166
       166
       +
       

     

       167
       167
       +
       // DisableAggregator updates an authorization to disabled

     

       168
       168
       +
       // Note: This is a PLACEHOLDER for the write-forward implementation

     

       169
       169
       +
       func (s *aggregatorService) DisableAggregator(ctx context.Context, req DisableAggregatorRequest) (*Authorization, error) {

     

       170
       170
       +
       	// Validate request

     

       171
       171
       +
       	if err := s.validateDisableRequest(ctx, req); err != nil {

     

       172
       172
       +
       		return nil, err

     

       173
       173
       +
       	}

     

       174
       174
       +
       

     

       175
       175
       +
       	// Verify authorization exists

     

       176
       176
       +
       	auth, err := s.repo.GetAuthorization(ctx, req.AggregatorDID, req.CommunityDID)

     

       177
       177
       +
       	if err != nil {

     

       178
       178
       +
       		return nil, err

     

       179
       179
       +
       	}

     

       180
       180
       +
       

     

       181
       181
       +
       	if !auth.Enabled {

     

       182
       182
       +
       		// Already disabled

     

       183
       183
       +
       		return auth, nil

     

       184
       184
       +
       	}

     

       185
       185
       +
       

     

       186
       186
       +
       	// TODO Phase 2: Write-forward to PDS

     

       187
       187
       +
       	// Update the authorization record with enabled=false

     

       188
       188
       +
       	return nil, ErrNotImplemented

     

       189
       189
       +
       }

     

       190
       190
       +
       

     

       191
       191
       +
       // UpdateAggregatorConfig updates an aggregator's configuration

     

       192
       192
       +
       // Note: This is a PLACEHOLDER for the write-forward implementation

     

       193
       193
       +
       func (s *aggregatorService) UpdateAggregatorConfig(ctx context.Context, req UpdateConfigRequest) (*Authorization, error) {

     

       194
       194
       +
       	// Validate request

     

       195
       195
       +
       	if err := s.validateUpdateConfigRequest(ctx, req); err != nil {

     

       196
       196
       +
       		return nil, err

     

       197
       197
       +
       	}

     

       198
       198
       +
       

     

       199
       199
       +
       	// Verify authorization exists

     

       200
       200
       +
       	auth, err := s.repo.GetAuthorization(ctx, req.AggregatorDID, req.CommunityDID)

     

       201
       201
       +
       	if err != nil {

     

       202
       202
       +
       		return nil, err

     

       203
       203
       +
       	}

     

       204
       204
       +
       

     

       205
       205
       +
       	// Get aggregator for schema validation

     

       206
       206
       +
       	aggregator, err := s.repo.GetAggregator(ctx, req.AggregatorDID)

     

       207
       207
       +
       	if err != nil {

     

       208
       208
       +
       		return nil, err

     

       209
       209
       +
       	}

     

       210
       210
       +
       

     

       211
       211
       +
       	// Validate new config against schema

     

       212
       212
       +
       	if len(req.Config) > 0 && len(aggregator.ConfigSchema) > 0 {

     

       213
       213
       +
       		if err := s.validateConfig(req.Config, aggregator.ConfigSchema); err != nil {

     

       214
       214
       +
       			return nil, err

     

       215
       215
       +
       		}

     

       216
       216
       +
       	}

     

       217
       217
       +
       

     

       218
       218
       +
       	// TODO Phase 2: Write-forward to PDS

     

       219
       219
       +
       	// Update the authorization record with new config

     

       220
       220
       +
       	return auth, ErrNotImplemented

     

       221
       221
       +
       }

     

       222
       222
       +
       

     

       223
       223
       +
       // ===== Validation and Authorization Checks =====

     

       224
       224
       +
       

     

       225
       225
       +
       // ValidateAggregatorPost validates that an aggregator can post to a community

     

       226
       226
       +
       // Checks: 1) Authorization exists and is enabled, 2) Rate limit not exceeded

     

       227
       227
       +
       // This is called by the post creation handler BEFORE writing to PDS

     

       228
       228
       +
       func (s *aggregatorService) ValidateAggregatorPost(ctx context.Context, aggregatorDID, communityDID string) error {

     

       229
       229
       +
       	// Check authorization exists and is enabled

     

       230
       230
       +
       	authorized, err := s.repo.IsAuthorized(ctx, aggregatorDID, communityDID)

     

       231
       231
       +
       	if err != nil {

     

       232
       232
       +
       		return fmt.Errorf("failed to check authorization: %w", err)

     

       233
       233
       +
       	}

     

       234
       234
       +
       	if !authorized {

     

       235
       235
       +
       		return ErrNotAuthorized

     

       236
       236
       +
       	}

     

       237
       237
       +
       

     

       238
       238
       +
       	// Check rate limit (10 posts per hour per community)

     

       239
       239
       +
       	since := time.Now().Add(-RateLimitWindow)

     

       240
       240
       +
       	recentPostCount, err := s.repo.CountRecentPosts(ctx, aggregatorDID, communityDID, since)

     

       241
       241
       +
       	if err != nil {

     

       242
       242
       +
       		return fmt.Errorf("failed to check rate limit: %w", err)

     

       243
       243
       +
       	}

     

       244
       244
       +
       

     

       245
       245
       +
       	if recentPostCount >= RateLimitMaxPosts {

     

       246
       246
       +
       		return ErrRateLimitExceeded

     

       247
       247
       +
       	}

     

       248
       248
       +
       

     

       249
       249
       +
       	return nil

     

       250
       250
       +
       }

     

       251
       251
       +
       

     

       252
       252
       +
       // IsAggregator checks if a DID is a registered aggregator

     

       253
       253
       +
       // Fast check used by post creation handler

     

       254
       254
       +
       func (s *aggregatorService) IsAggregator(ctx context.Context, did string) (bool, error) {

     

       255
       255
       +
       	if did == "" {

     

       256
       256
       +
       		return false, nil

     

       257
       257
       +
       	}

     

       258
       258
       +
       	return s.repo.IsAggregator(ctx, did)

     

       259
       259
       +
       }

     

       260
       260
       +
       

     

       261
       261
       +
       // RecordAggregatorPost tracks a post created by an aggregator

     

       262
       262
       +
       // Called AFTER successful post creation to update statistics and rate limiting

     

       263
       263
       +
       func (s *aggregatorService) RecordAggregatorPost(ctx context.Context, aggregatorDID, communityDID, postURI, postCID string) error {

     

       264
       264
       +
       	if aggregatorDID == "" || communityDID == "" || postURI == "" || postCID == "" {

     

       265
       265
       +
       		return NewValidationError("post_tracking", "aggregatorDID, communityDID, postURI, and postCID are required")

     

       266
       266
       +
       	}

     

       267
       267
       +
       

     

       268
       268
       +
       	return s.repo.RecordAggregatorPost(ctx, aggregatorDID, communityDID, postURI, postCID)

     

       269
       269
       +
       }

     

       270
       270
       +
       

     

       271
       271
       +
       // ===== Validation Helpers =====

     

       272
       272
       +
       

     

       273
       273
       +
       func (s *aggregatorService) validateEnableRequest(ctx context.Context, req EnableAggregatorRequest) error {

     

       274
       274
       +
       	if req.AggregatorDID == "" {

     

       275
       275
       +
       		return NewValidationError("aggregatorDid", "aggregator DID is required")

     

       276
       276
       +
       	}

     

       277
       277
       +
       	if req.CommunityDID == "" {

     

       278
       278
       +
       		return NewValidationError("communityDid", "community DID is required")

     

       279
       279
       +
       	}

     

       280
       280
       +
       	if req.EnabledByDID == "" {

     

       281
       281
       +
       		return NewValidationError("enabledByDid", "enabledByDID is required")

     

       282
       282
       +
       	}

     

       283
       283
       +
       

     

       284
       284
       +
       	// Verify user is a moderator of the community

     

       285
       285
       +
       	// TODO: Implement moderator check

     

       286
       286
       +
       	// membership, err := s.communityService.GetMembership(ctx, req.EnabledByDID, req.CommunityDID)

     

       287
       287
       +
       	// if err != nil || !membership.IsModerator {

     

       288
       288
       +
       	//     return ErrNotModerator

     

       289
       289
       +
       	// }

     

       290
       290
       +
       

     

       291
       291
       +
       	return nil

     

       292
       292
       +
       }

     

       293
       293
       +
       

     

       294
       294
       +
       func (s *aggregatorService) validateDisableRequest(ctx context.Context, req DisableAggregatorRequest) error {

     

       295
       295
       +
       	if req.AggregatorDID == "" {

     

       296
       296
       +
       		return NewValidationError("aggregatorDid", "aggregator DID is required")

     

       297
       297
       +
       	}

     

       298
       298
       +
       	if req.CommunityDID == "" {

     

       299
       299
       +
       		return NewValidationError("communityDid", "community DID is required")

     

       300
       300
       +
       	}

     

       301
       301
       +
       	if req.DisabledByDID == "" {

     

       302
       302
       +
       		return NewValidationError("disabledByDid", "disabledByDID is required")

     

       303
       303
       +
       	}

     

       304
       304
       +
       

     

       305
       305
       +
       	// Verify user is a moderator of the community

     

       306
       306
       +
       	// TODO: Implement moderator check

     

       307
       307
       +
       

     

       308
       308
       +
       	return nil

     

       309
       309
       +
       }

     

       310
       310
       +
       

     

       311
       311
       +
       func (s *aggregatorService) validateUpdateConfigRequest(ctx context.Context, req UpdateConfigRequest) error {

     

       312
       312
       +
       	if req.AggregatorDID == "" {

     

       313
       313
       +
       		return NewValidationError("aggregatorDid", "aggregator DID is required")

     

       314
       314
       +
       	}

     

       315
       315
       +
       	if req.CommunityDID == "" {

     

       316
       316
       +
       		return NewValidationError("communityDid", "community DID is required")

     

       317
       317
       +
       	}

     

       318
       318
       +
       	if req.UpdatedByDID == "" {

     

       319
       319
       +
       		return NewValidationError("updatedByDid", "updatedByDID is required")

     

       320
       320
       +
       	}

     

       321
       321
       +
       	if len(req.Config) == 0 {

     

       322
       322
       +
       		return NewValidationError("config", "config is required")

     

       323
       323
       +
       	}

     

       324
       324
       +
       

     

       325
       325
       +
       	// Verify user is a moderator of the community

     

       326
       326
       +
       	// TODO: Implement moderator check

     

       327
       327
       +
       

     

       328
       328
       +
       	return nil

     

       329
       329
       +
       }

     

       330
       330
       +
       

     

       331
       331
       +
       // validateConfig validates a config object against a JSON Schema

     

       332
       332
       +
       // Following Bluesky's pattern for feed generator configuration

     

       333
       333
       +
       func (s *aggregatorService) validateConfig(config map[string]interface{}, schemaBytes []byte) error {

     

       334
       334
       +
       	// Parse schema

     

       335
       335
       +
       	schemaLoader := gojsonschema.NewBytesLoader(schemaBytes)

     

       336
       336
       +
       

     

       337
       337
       +
       	// Convert config to JSON bytes

     

       338
       338
       +
       	configBytes, err := json.Marshal(config)

     

       339
       339
       +
       	if err != nil {

     

       340
       340
       +
       		return fmt.Errorf("failed to marshal config: %w", err)

     

       341
       341
       +
       	}

     

       342
       342
       +
       	configLoader := gojsonschema.NewBytesLoader(configBytes)

     

       343
       343
       +
       

     

       344
       344
       +
       	// Validate

     

       345
       345
       +
       	result, err := gojsonschema.Validate(schemaLoader, configLoader)

     

       346
       346
       +
       	if err != nil {

     

       347
       347
       +
       		return fmt.Errorf("failed to validate config: %w", err)

     

       348
       348
       +
       	}

     

       349
       349
       +
       

     

       350
       350
       +
       	if !result.Valid() {

     

       351
       351
       +
       		// Collect validation errors

     

       352
       352
       +
       		var errorMessages []string

     

       353
       353
       +
       		for _, desc := range result.Errors() {

     

       354
       354
       +
       			errorMessages = append(errorMessages, desc.String())

     

       355
       355
       +
       		}

     

       356
       356
       +
       		return fmt.Errorf("%w: %s", ErrConfigSchemaValidation, errorMessages)

     

       357
       357
       +
       	}

     

       358
       358
       +
       

     

       359
       359
       +
       	return nil

     

       360
       360
       +
       }

+813

internal/db/postgres/aggregator_repo.go

···

       1
       1
       +
       package postgres

     

       2
       2
       +
       

     

       3
       3
       +
       import (

     

       4
       4
       +
       	"Coves/internal/core/aggregators"

     

       5
       5
       +
       	"context"

     

       6
       6
       +
       	"database/sql"

     

       7
       7
       +
       	"fmt"

     

       8
       8
       +
       	"strings"

     

       9
       9
       +
       	"time"

     

       10
       10
       +
       )

     

       11
       11
       +
       

     

       12
       12
       +
       type postgresAggregatorRepo struct {

     

       13
       13
       +
       	db *sql.DB

     

       14
       14
       +
       }

     

       15
       15
       +
       

     

       16
       16
       +
       // NewAggregatorRepository creates a new PostgreSQL aggregator repository

     

       17
       17
       +
       func NewAggregatorRepository(db *sql.DB) aggregators.Repository {

     

       18
       18
       +
       	return &postgresAggregatorRepo{db: db}

     

       19
       19
       +
       }

     

       20
       20
       +
       

     

       21
       21
       +
       // ===== Aggregator CRUD Operations =====

     

       22
       22
       +
       

     

       23
       23
       +
       // CreateAggregator indexes a new aggregator service declaration from the firehose

     

       24
       24
       +
       func (r *postgresAggregatorRepo) CreateAggregator(ctx context.Context, agg *aggregators.Aggregator) error {

     

       25
       25
       +
       	query := `

     

       26
       26
       +
       		INSERT INTO aggregators (

     

       27
       27
       +
       			did, display_name, description, avatar_url, config_schema,

     

       28
       28
       +
       			maintainer_did, source_url, created_at, indexed_at, record_uri, record_cid

     

       29
       29
       +
       		) VALUES (

     

       30
       30
       +
       			$1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11

     

       31
       31
       +
       		)

     

       32
       32
       +
       		ON CONFLICT (did) DO UPDATE SET

     

       33
       33
       +
       			display_name = EXCLUDED.display_name,

     

       34
       34
       +
       			description = EXCLUDED.description,

     

       35
       35
       +
       			avatar_url = EXCLUDED.avatar_url,

     

       36
       36
       +
       			config_schema = EXCLUDED.config_schema,

     

       37
       37
       +
       			maintainer_did = EXCLUDED.maintainer_did,

     

       38
       38
       +
       			source_url = EXCLUDED.source_url,

     

       39
       39
       +
       			created_at = EXCLUDED.created_at,

     

       40
       40
       +
       			indexed_at = EXCLUDED.indexed_at,

     

       41
       41
       +
       			record_uri = EXCLUDED.record_uri,

     

       42
       42
       +
       			record_cid = EXCLUDED.record_cid`

     

       43
       43
       +
       

     

       44
       44
       +
       	var configSchema interface{}

     

       45
       45
       +
       	if len(agg.ConfigSchema) > 0 {

     

       46
       46
       +
       		configSchema = agg.ConfigSchema

     

       47
       47
       +
       	} else {

     

       48
       48
       +
       		configSchema = nil

     

       49
       49
       +
       	}

     

       50
       50
       +
       

     

       51
       51
       +
       	_, err := r.db.ExecContext(ctx, query,

     

       52
       52
       +
       		agg.DID,

     

       53
       53
       +
       		agg.DisplayName,

     

       54
       54
       +
       		nullString(agg.Description),

     

       55
       55
       +
       		nullString(agg.AvatarURL),

     

       56
       56
       +
       		configSchema,

     

       57
       57
       +
       		nullString(agg.MaintainerDID),

     

       58
       58
       +
       		nullString(agg.SourceURL),

     

       59
       59
       +
       		agg.CreatedAt,

     

       60
       60
       +
       		agg.IndexedAt,

     

       61
       61
       +
       		nullString(agg.RecordURI),

     

       62
       62
       +
       		nullString(agg.RecordCID),

     

       63
       63
       +
       	)

     

       64
       64
       +
       

     

       65
       65
       +
       	if err != nil {

     

       66
       66
       +
       		return fmt.Errorf("failed to create aggregator: %w", err)

     

       67
       67
       +
       	}

     

       68
       68
       +
       

     

       69
       69
       +
       	return nil

     

       70
       70
       +
       }

     

       71
       71
       +
       

     

       72
       72
       +
       // GetAggregator retrieves an aggregator by DID

     

       73
       73
       +
       func (r *postgresAggregatorRepo) GetAggregator(ctx context.Context, did string) (*aggregators.Aggregator, error) {

     

       74
       74
       +
       	query := `

     

       75
       75
       +
       		SELECT

     

       76
       76
       +
       			did, display_name, description, avatar_url, config_schema,

     

       77
       77
       +
       			maintainer_did, source_url, communities_using, posts_created,

     

       78
       78
       +
       			created_at, indexed_at, record_uri, record_cid

     

       79
       79
       +
       		FROM aggregators

     

       80
       80
       +
       		WHERE did = $1`

     

       81
       81
       +
       

     

       82
       82
       +
       	agg := &aggregators.Aggregator{}

     

       83
       83
       +
       	var description, avatarCID, maintainerDID, homepageURL, recordURI, recordCID sql.NullString

     

       84
       84
       +
       	var configSchema []byte

     

       85
       85
       +
       

     

       86
       86
       +
       	err := r.db.QueryRowContext(ctx, query, did).Scan(

     

       87
       87
       +
       		&agg.DID,

     

       88
       88
       +
       		&agg.DisplayName,

     

       89
       89
       +
       		&description,

     

       90
       90
       +
       		&avatarCID,

     

       91
       91
       +
       		&configSchema,

     

       92
       92
       +
       		&maintainerDID,

     

       93
       93
       +
       		&homepageURL,

     

       94
       94
       +
       		&agg.CommunitiesUsing,

     

       95
       95
       +
       		&agg.PostsCreated,

     

       96
       96
       +
       		&agg.CreatedAt,

     

       97
       97
       +
       		&agg.IndexedAt,

     

       98
       98
       +
       		&recordURI,

     

       99
       99
       +
       		&recordCID,

     

       100
       100
       +
       	)

     

       101
       101
       +
       

     

       102
       102
       +
       	if err == sql.ErrNoRows {

     

       103
       103
       +
       		return nil, aggregators.ErrAggregatorNotFound

     

       104
       104
       +
       	}

     

       105
       105
       +
       	if err != nil {

     

       106
       106
       +
       		return nil, fmt.Errorf("failed to get aggregator: %w", err)

     

       107
       107
       +
       	}

     

       108
       108
       +
       

     

       109
       109
       +
       	// Map nullable fields

     

       110
       110
       +
       	agg.Description = description.String

     

       111
       111
       +
       	agg.AvatarURL = avatarCID.String

     

       112
       112
       +
       	agg.MaintainerDID = maintainerDID.String

     

       113
       113
       +
       	agg.SourceURL = homepageURL.String

     

       114
       114
       +
       	agg.RecordURI = recordURI.String

     

       115
       115
       +
       	agg.RecordCID = recordCID.String

     

       116
       116
       +
       	if configSchema != nil {

     

       117
       117
       +
       		agg.ConfigSchema = configSchema

     

       118
       118
       +
       	}

     

       119
       119
       +
       

     

       120
       120
       +
       	return agg, nil

     

       121
       121
       +
       }

     

       122
       122
       +
       

     

       123
       123
       +
       // GetAggregatorsByDIDs retrieves multiple aggregators by DIDs in a single query (avoids N+1)

     

       124
       124
       +
       func (r *postgresAggregatorRepo) GetAggregatorsByDIDs(ctx context.Context, dids []string) ([]*aggregators.Aggregator, error) {

     

       125
       125
       +
       	if len(dids) == 0 {

     

       126
       126
       +
       		return []*aggregators.Aggregator{}, nil

     

       127
       127
       +
       	}

     

       128
       128
       +
       

     

       129
       129
       +
       	// Build IN clause with placeholders

     

       130
       130
       +
       	placeholders := make([]string, len(dids))

     

       131
       131
       +
       	args := make([]interface{}, len(dids))

     

       132
       132
       +
       	for i, did := range dids {

     

       133
       133
       +
       		placeholders[i] = fmt.Sprintf("$%d", i+1)

     

       134
       134
       +
       		args[i] = did

     

       135
       135
       +
       	}

     

       136
       136
       +
       

     

       137
       137
       +
       	query := fmt.Sprintf(`

     

       138
       138
       +
       		SELECT

     

       139
       139
       +
       			did, display_name, description, avatar_url, config_schema,

     

       140
       140
       +
       			maintainer_did, source_url, communities_using, posts_created,

     

       141
       141
       +
       			created_at, indexed_at, record_uri, record_cid

     

       142
       142
       +
       		FROM aggregators

     

       143
       143
       +
       		WHERE did IN (%s)`, strings.Join(placeholders, ", "))

     

       144
       144
       +
       

     

       145
       145
       +
       	rows, err := r.db.QueryContext(ctx, query, args...)

     

       146
       146
       +
       	if err != nil {

     

       147
       147
       +
       		return nil, fmt.Errorf("failed to get aggregators: %w", err)

     

       148
       148
       +
       	}

     

       149
       149
       +
       	defer rows.Close()

     

       150
       150
       +
       

     

       151
       151
       +
       	var results []*aggregators.Aggregator

     

       152
       152
       +
       	for rows.Next() {

     

       153
       153
       +
       		agg := &aggregators.Aggregator{}

     

       154
       154
       +
       		var description, avatarCID, maintainerDID, homepageURL, recordURI, recordCID sql.NullString

     

       155
       155
       +
       		var configSchema []byte

     

       156
       156
       +
       

     

       157
       157
       +
       		err := rows.Scan(

     

       158
       158
       +
       			&agg.DID,

     

       159
       159
       +
       			&agg.DisplayName,

     

       160
       160
       +
       			&description,

     

       161
       161
       +
       			&avatarCID,

     

       162
       162
       +
       			&configSchema,

     

       163
       163
       +
       			&maintainerDID,

     

       164
       164
       +
       			&homepageURL,

     

       165
       165
       +
       			&agg.CommunitiesUsing,

     

       166
       166
       +
       			&agg.PostsCreated,

     

       167
       167
       +
       			&agg.CreatedAt,

     

       168
       168
       +
       			&agg.IndexedAt,

     

       169
       169
       +
       			&recordURI,

     

       170
       170
       +
       			&recordCID,

     

       171
       171
       +
       		)

     

       172
       172
       +
       		if err != nil {

     

       173
       173
       +
       			return nil, fmt.Errorf("failed to scan aggregator: %w", err)

     

       174
       174
       +
       		}

     

       175
       175
       +
       

     

       176
       176
       +
       		// Map nullable fields

     

       177
       177
       +
       		agg.Description = description.String

     

       178
       178
       +
       		agg.AvatarURL = avatarCID.String

     

       179
       179
       +
       		agg.MaintainerDID = maintainerDID.String

     

       180
       180
       +
       		agg.SourceURL = homepageURL.String

     

       181
       181
       +
       		agg.RecordURI = recordURI.String

     

       182
       182
       +
       		agg.RecordCID = recordCID.String

     

       183
       183
       +
       		if configSchema != nil {

     

       184
       184
       +
       			agg.ConfigSchema = configSchema

     

       185
       185
       +
       		}

     

       186
       186
       +
       

     

       187
       187
       +
       		results = append(results, agg)

     

       188
       188
       +
       	}

     

       189
       189
       +
       

     

       190
       190
       +
       	if err = rows.Err(); err != nil {

     

       191
       191
       +
       		return nil, fmt.Errorf("error iterating aggregators: %w", err)

     

       192
       192
       +
       	}

     

       193
       193
       +
       

     

       194
       194
       +
       	return results, nil

     

       195
       195
       +
       }

     

       196
       196
       +
       

     

       197
       197
       +
       // UpdateAggregator updates an existing aggregator

     

       198
       198
       +
       func (r *postgresAggregatorRepo) UpdateAggregator(ctx context.Context, agg *aggregators.Aggregator) error {

     

       199
       199
       +
       	query := `

     

       200
       200
       +
       		UPDATE aggregators SET

     

       201
       201
       +
       			display_name = $2,

     

       202
       202
       +
       			description = $3,

     

       203
       203
       +
       			avatar_url = $4,

     

       204
       204
       +
       			config_schema = $5,

     

       205
       205
       +
       			maintainer_did = $6,

     

       206
       206
       +
       			source_url = $7,

     

       207
       207
       +
       			created_at = $8,

     

       208
       208
       +
       			indexed_at = $9,

     

       209
       209
       +
       			record_uri = $10,

     

       210
       210
       +
       			record_cid = $11

     

       211
       211
       +
       		WHERE did = $1`

     

       212
       212
       +
       

     

       213
       213
       +
       	var configSchema interface{}

     

       214
       214
       +
       	if len(agg.ConfigSchema) > 0 {

     

       215
       215
       +
       		configSchema = agg.ConfigSchema

     

       216
       216
       +
       	} else {

     

       217
       217
       +
       		configSchema = nil

     

       218
       218
       +
       	}

     

       219
       219
       +
       

     

       220
       220
       +
       	result, err := r.db.ExecContext(ctx, query,

     

       221
       221
       +
       		agg.DID,

     

       222
       222
       +
       		agg.DisplayName,

     

       223
       223
       +
       		nullString(agg.Description),

     

       224
       224
       +
       		nullString(agg.AvatarURL),

     

       225
       225
       +
       		configSchema,

     

       226
       226
       +
       		nullString(agg.MaintainerDID),

     

       227
       227
       +
       		nullString(agg.SourceURL),

     

       228
       228
       +
       		agg.CreatedAt,

     

       229
       229
       +
       		agg.IndexedAt,

     

       230
       230
       +
       		nullString(agg.RecordURI),

     

       231
       231
       +
       		nullString(agg.RecordCID),

     

       232
       232
       +
       	)

     

       233
       233
       +
       

     

       234
       234
       +
       	if err != nil {

     

       235
       235
       +
       		return fmt.Errorf("failed to update aggregator: %w", err)

     

       236
       236
       +
       	}

     

       237
       237
       +
       

     

       238
       238
       +
       	rows, err := result.RowsAffected()

     

       239
       239
       +
       	if err != nil {

     

       240
       240
       +
       		return fmt.Errorf("failed to get rows affected: %w", err)

     

       241
       241
       +
       	}

     

       242
       242
       +
       	if rows == 0 {

     

       243
       243
       +
       		return aggregators.ErrAggregatorNotFound

     

       244
       244
       +
       	}

     

       245
       245
       +
       

     

       246
       246
       +
       	return nil

     

       247
       247
       +
       }

     

       248
       248
       +
       

     

       249
       249
       +
       // DeleteAggregator removes an aggregator (cascade deletes authorizations and posts via FK)

     

       250
       250
       +
       func (r *postgresAggregatorRepo) DeleteAggregator(ctx context.Context, did string) error {

     

       251
       251
       +
       	query := `DELETE FROM aggregators WHERE did = $1`

     

       252
       252
       +
       

     

       253
       253
       +
       	result, err := r.db.ExecContext(ctx, query, did)

     

       254
       254
       +
       	if err != nil {

     

       255
       255
       +
       		return fmt.Errorf("failed to delete aggregator: %w", err)

     

       256
       256
       +
       	}

     

       257
       257
       +
       

     

       258
       258
       +
       	rows, err := result.RowsAffected()

     

       259
       259
       +
       	if err != nil {

     

       260
       260
       +
       		return fmt.Errorf("failed to get rows affected: %w", err)

     

       261
       261
       +
       	}

     

       262
       262
       +
       	if rows == 0 {

     

       263
       263
       +
       		return aggregators.ErrAggregatorNotFound

     

       264
       264
       +
       	}

     

       265
       265
       +
       

     

       266
       266
       +
       	return nil

     

       267
       267
       +
       }

     

       268
       268
       +
       

     

       269
       269
       +
       // ListAggregators retrieves all aggregators with pagination

     

       270
       270
       +
       func (r *postgresAggregatorRepo) ListAggregators(ctx context.Context, limit, offset int) ([]*aggregators.Aggregator, error) {

     

       271
       271
       +
       	query := `

     

       272
       272
       +
       		SELECT

     

       273
       273
       +
       			did, display_name, description, avatar_url, config_schema,

     

       274
       274
       +
       			maintainer_did, source_url, communities_using, posts_created,

     

       275
       275
       +
       			created_at, indexed_at, record_uri, record_cid

     

       276
       276
       +
       		FROM aggregators

     

       277
       277
       +
       		ORDER BY communities_using DESC, display_name ASC

     

       278
       278
       +
       		LIMIT $1 OFFSET $2`

     

       279
       279
       +
       

     

       280
       280
       +
       	rows, err := r.db.QueryContext(ctx, query, limit, offset)

     

       281
       281
       +
       	if err != nil {

     

       282
       282
       +
       		return nil, fmt.Errorf("failed to list aggregators: %w", err)

     

       283
       283
       +
       	}

     

       284
       284
       +
       	defer rows.Close()

     

       285
       285
       +
       

     

       286
       286
       +
       	var aggs []*aggregators.Aggregator

     

       287
       287
       +
       	for rows.Next() {

     

       288
       288
       +
       		agg := &aggregators.Aggregator{}

     

       289
       289
       +
       		var description, avatarCID, maintainerDID, homepageURL, recordURI, recordCID sql.NullString

     

       290
       290
       +
       		var configSchema []byte

     

       291
       291
       +
       

     

       292
       292
       +
       		err := rows.Scan(

     

       293
       293
       +
       			&agg.DID,

     

       294
       294
       +
       			&agg.DisplayName,

     

       295
       295
       +
       			&description,

     

       296
       296
       +
       			&avatarCID,

     

       297
       297
       +
       			&configSchema,

     

       298
       298
       +
       			&maintainerDID,

     

       299
       299
       +
       			&homepageURL,

     

       300
       300
       +
       			&agg.CommunitiesUsing,

     

       301
       301
       +
       			&agg.PostsCreated,

     

       302
       302
       +
       			&agg.CreatedAt,

     

       303
       303
       +
       			&agg.IndexedAt,

     

       304
       304
       +
       			&recordURI,

     

       305
       305
       +
       			&recordCID,

     

       306
       306
       +
       		)

     

       307
       307
       +
       		if err != nil {

     

       308
       308
       +
       			return nil, fmt.Errorf("failed to scan aggregator: %w", err)

     

       309
       309
       +
       		}

     

       310
       310
       +
       

     

       311
       311
       +
       		// Map nullable fields

     

       312
       312
       +
       		agg.Description = description.String

     

       313
       313
       +
       		agg.AvatarURL = avatarCID.String

     

       314
       314
       +
       		agg.MaintainerDID = maintainerDID.String

     

       315
       315
       +
       		agg.SourceURL = homepageURL.String

     

       316
       316
       +
       		agg.RecordURI = recordURI.String

     

       317
       317
       +
       		agg.RecordCID = recordCID.String

     

       318
       318
       +
       		if configSchema != nil {

     

       319
       319
       +
       			agg.ConfigSchema = configSchema

     

       320
       320
       +
       		}

     

       321
       321
       +
       

     

       322
       322
       +
       		aggs = append(aggs, agg)

     

       323
       323
       +
       	}

     

       324
       324
       +
       

     

       325
       325
       +
       	if err = rows.Err(); err != nil {

     

       326
       326
       +
       		return nil, fmt.Errorf("error iterating aggregators: %w", err)

     

       327
       327
       +
       	}

     

       328
       328
       +
       

     

       329
       329
       +
       	return aggs, nil

     

       330
       330
       +
       }

     

       331
       331
       +
       

     

       332
       332
       +
       // IsAggregator performs a fast existence check for post creation handler

     

       333
       333
       +
       func (r *postgresAggregatorRepo) IsAggregator(ctx context.Context, did string) (bool, error) {

     

       334
       334
       +
       	query := `SELECT EXISTS(SELECT 1 FROM aggregators WHERE did = $1)`

     

       335
       335
       +
       

     

       336
       336
       +
       	var exists bool

     

       337
       337
       +
       	err := r.db.QueryRowContext(ctx, query, did).Scan(&exists)

     

       338
       338
       +
       	if err != nil {

     

       339
       339
       +
       		return false, fmt.Errorf("failed to check if aggregator exists: %w", err)

     

       340
       340
       +
       	}

     

       341
       341
       +
       

     

       342
       342
       +
       	return exists, nil

     

       343
       343
       +
       }

     

       344
       344
       +
       

     

       345
       345
       +
       // ===== Authorization CRUD Operations =====

     

       346
       346
       +
       

     

       347
       347
       +
       // CreateAuthorization indexes a new authorization from the firehose

     

       348
       348
       +
       func (r *postgresAggregatorRepo) CreateAuthorization(ctx context.Context, auth *aggregators.Authorization) error {

     

       349
       349
       +
       	query := `

     

       350
       350
       +
       		INSERT INTO aggregator_authorizations (

     

       351
       351
       +
       			aggregator_did, community_did, enabled, config,

     

       352
       352
       +
       			created_at, created_by, disabled_at, disabled_by,

     

       353
       353
       +
       			indexed_at, record_uri, record_cid

     

       354
       354
       +
       		) VALUES (

     

       355
       355
       +
       			$1, $2, $3, $4, $5, $6, $7, $8, $9, $10, $11

     

       356
       356
       +
       		)

     

       357
       357
       +
       		ON CONFLICT (aggregator_did, community_did) DO UPDATE SET

     

       358
       358
       +
       			enabled = EXCLUDED.enabled,

     

       359
       359
       +
       			config = EXCLUDED.config,

     

       360
       360
       +
       			created_at = EXCLUDED.created_at,

     

       361
       361
       +
       			created_by = EXCLUDED.created_by,

     

       362
       362
       +
       			disabled_at = EXCLUDED.disabled_at,

     

       363
       363
       +
       			disabled_by = EXCLUDED.disabled_by,

     

       364
       364
       +
       			indexed_at = EXCLUDED.indexed_at,

     

       365
       365
       +
       			record_uri = EXCLUDED.record_uri,

     

       366
       366
       +
       			record_cid = EXCLUDED.record_cid

     

       367
       367
       +
       		RETURNING id`

     

       368
       368
       +
       

     

       369
       369
       +
       	var config interface{}

     

       370
       370
       +
       	if len(auth.Config) > 0 {

     

       371
       371
       +
       		config = auth.Config

     

       372
       372
       +
       	} else {

     

       373
       373
       +
       		config = nil

     

       374
       374
       +
       	}

     

       375
       375
       +
       

     

       376
       376
       +
       	var disabledAt interface{}

     

       377
       377
       +
       	if auth.DisabledAt != nil {

     

       378
       378
       +
       		disabledAt = *auth.DisabledAt

     

       379
       379
       +
       	} else {

     

       380
       380
       +
       		disabledAt = nil

     

       381
       381
       +
       	}

     

       382
       382
       +
       

     

       383
       383
       +
       	err := r.db.QueryRowContext(ctx, query,

     

       384
       384
       +
       		auth.AggregatorDID,

     

       385
       385
       +
       		auth.CommunityDID,

     

       386
       386
       +
       		auth.Enabled,

     

       387
       387
       +
       		config,

     

       388
       388
       +
       		auth.CreatedAt,

     

       389
       389
       +
       		auth.CreatedBy, // Required field, no nullString needed

     

       390
       390
       +
       		disabledAt,

     

       391
       391
       +
       		nullString(auth.DisabledBy),

     

       392
       392
       +
       		auth.IndexedAt,

     

       393
       393
       +
       		nullString(auth.RecordURI),

     

       394
       394
       +
       		nullString(auth.RecordCID),

     

       395
       395
       +
       	).Scan(&auth.ID)

     

       396
       396
       +
       

     

       397
       397
       +
       	if err != nil {

     

       398
       398
       +
       		// Check for foreign key violations

     

       399
       399
       +
       		if strings.Contains(err.Error(), "fk_aggregator") {

     

       400
       400
       +
       			return aggregators.ErrAggregatorNotFound

     

       401
       401
       +
       		}

     

       402
       402
       +
       		return fmt.Errorf("failed to create authorization: %w", err)

     

       403
       403
       +
       	}

     

       404
       404
       +
       

     

       405
       405
       +
       	return nil

     

       406
       406
       +
       }

     

       407
       407
       +
       

     

       408
       408
       +
       // GetAuthorization retrieves an authorization by aggregator and community DID

     

       409
       409
       +
       func (r *postgresAggregatorRepo) GetAuthorization(ctx context.Context, aggregatorDID, communityDID string) (*aggregators.Authorization, error) {

     

       410
       410
       +
       	query := `

     

       411
       411
       +
       		SELECT

     

       412
       412
       +
       			id, aggregator_did, community_did, enabled, config,

     

       413
       413
       +
       			created_at, created_by, disabled_at, disabled_by,

     

       414
       414
       +
       			indexed_at, record_uri, record_cid

     

       415
       415
       +
       		FROM aggregator_authorizations

     

       416
       416
       +
       		WHERE aggregator_did = $1 AND community_did = $2`

     

       417
       417
       +
       

     

       418
       418
       +
       	auth := &aggregators.Authorization{}

     

       419
       419
       +
       	var config []byte

     

       420
       420
       +
       	var createdBy, disabledBy, recordURI, recordCID sql.NullString

     

       421
       421
       +
       	var disabledAt sql.NullTime

     

       422
       422
       +
       

     

       423
       423
       +
       	err := r.db.QueryRowContext(ctx, query, aggregatorDID, communityDID).Scan(

     

       424
       424
       +
       		&auth.ID,

     

       425
       425
       +
       		&auth.AggregatorDID,

     

       426
       426
       +
       		&auth.CommunityDID,

     

       427
       427
       +
       		&auth.Enabled,

     

       428
       428
       +
       		&config,

     

       429
       429
       +
       		&auth.CreatedAt,

     

       430
       430
       +
       		&createdBy,

     

       431
       431
       +
       		&disabledAt,

     

       432
       432
       +
       		&disabledBy,

     

       433
       433
       +
       		&auth.IndexedAt,

     

       434
       434
       +
       		&recordURI,

     

       435
       435
       +
       		&recordCID,

     

       436
       436
       +
       	)

     

       437
       437
       +
       

     

       438
       438
       +
       	if err == sql.ErrNoRows {

     

       439
       439
       +
       		return nil, aggregators.ErrAuthorizationNotFound

     

       440
       440
       +
       	}

     

       441
       441
       +
       	if err != nil {

     

       442
       442
       +
       		return nil, fmt.Errorf("failed to get authorization: %w", err)

     

       443
       443
       +
       	}

     

       444
       444
       +
       

     

       445
       445
       +
       	// Map nullable fields

     

       446
       446
       +
       	auth.CreatedBy = createdBy.String

     

       447
       447
       +
       	auth.DisabledBy = disabledBy.String

     

       448
       448
       +
       	if disabledAt.Valid {

     

       449
       449
       +
       		disabledAtVal := disabledAt.Time

     

       450
       450
       +
       		auth.DisabledAt = &disabledAtVal

     

       451
       451
       +
       	}

     

       452
       452
       +
       	auth.RecordURI = recordURI.String

     

       453
       453
       +
       	auth.RecordCID = recordCID.String

     

       454
       454
       +
       	if config != nil {

     

       455
       455
       +
       		auth.Config = config

     

       456
       456
       +
       	}

     

       457
       457
       +
       

     

       458
       458
       +
       	return auth, nil

     

       459
       459
       +
       }

     

       460
       460
       +
       

     

       461
       461
       +
       // GetAuthorizationByURI retrieves an authorization by record URI (for Jetstream delete operations)

     

       462
       462
       +
       func (r *postgresAggregatorRepo) GetAuthorizationByURI(ctx context.Context, recordURI string) (*aggregators.Authorization, error) {

     

       463
       463
       +
       	query := `

     

       464
       464
       +
       		SELECT

     

       465
       465
       +
       			id, aggregator_did, community_did, enabled, config,

     

       466
       466
       +
       			created_at, created_by, disabled_at, disabled_by,

     

       467
       467
       +
       			indexed_at, record_uri, record_cid

     

       468
       468
       +
       		FROM aggregator_authorizations

     

       469
       469
       +
       		WHERE record_uri = $1`

     

       470
       470
       +
       

     

       471
       471
       +
       	auth := &aggregators.Authorization{}

     

       472
       472
       +
       	var config []byte

     

       473
       473
       +
       	var createdBy, disabledBy, recordURIField, recordCID sql.NullString

     

       474
       474
       +
       	var disabledAt sql.NullTime

     

       475
       475
       +
       

     

       476
       476
       +
       	err := r.db.QueryRowContext(ctx, query, recordURI).Scan(

     

       477
       477
       +
       		&auth.ID,

     

       478
       478
       +
       		&auth.AggregatorDID,

     

       479
       479
       +
       		&auth.CommunityDID,

     

       480
       480
       +
       		&auth.Enabled,

     

       481
       481
       +
       		&config,

     

       482
       482
       +
       		&auth.CreatedAt,

     

       483
       483
       +
       		&createdBy,

     

       484
       484
       +
       		&disabledAt,

     

       485
       485
       +
       		&disabledBy,

     

       486
       486
       +
       		&auth.IndexedAt,

     

       487
       487
       +
       		&recordURIField,

     

       488
       488
       +
       		&recordCID,

     

       489
       489
       +
       	)

     

       490
       490
       +
       

     

       491
       491
       +
       	if err == sql.ErrNoRows {

     

       492
       492
       +
       		return nil, aggregators.ErrAuthorizationNotFound

     

       493
       493
       +
       	}

     

       494
       494
       +
       	if err != nil {

     

       495
       495
       +
       		return nil, fmt.Errorf("failed to get authorization by URI: %w", err)

     

       496
       496
       +
       	}

     

       497
       497
       +
       

     

       498
       498
       +
       	// Map nullable fields

     

       499
       499
       +
       	auth.CreatedBy = createdBy.String

     

       500
       500
       +
       	auth.DisabledBy = disabledBy.String

     

       501
       501
       +
       	if disabledAt.Valid {

     

       502
       502
       +
       		disabledAtVal := disabledAt.Time

     

       503
       503
       +
       		auth.DisabledAt = &disabledAtVal

     

       504
       504
       +
       	}

     

       505
       505
       +
       	auth.RecordURI = recordURIField.String

     

       506
       506
       +
       	auth.RecordCID = recordCID.String

     

       507
       507
       +
       	if config != nil {

     

       508
       508
       +
       		auth.Config = config

     

       509
       509
       +
       	}

     

       510
       510
       +
       

     

       511
       511
       +
       	return auth, nil

     

       512
       512
       +
       }

     

       513
       513
       +
       

     

       514
       514
       +
       // UpdateAuthorization updates an existing authorization

     

       515
       515
       +
       func (r *postgresAggregatorRepo) UpdateAuthorization(ctx context.Context, auth *aggregators.Authorization) error {

     

       516
       516
       +
       	query := `

     

       517
       517
       +
       		UPDATE aggregator_authorizations SET

     

       518
       518
       +
       			enabled = $3,

     

       519
       519
       +
       			config = $4,

     

       520
       520
       +
       			created_at = $5,

     

       521
       521
       +
       			created_by = $6,

     

       522
       522
       +
       			disabled_at = $7,

     

       523
       523
       +
       			disabled_by = $8,

     

       524
       524
       +
       			indexed_at = $9,

     

       525
       525
       +
       			record_uri = $10,

     

       526
       526
       +
       			record_cid = $11

     

       527
       527
       +
       		WHERE aggregator_did = $1 AND community_did = $2`

     

       528
       528
       +
       

     

       529
       529
       +
       	var config interface{}

     

       530
       530
       +
       	if len(auth.Config) > 0 {

     

       531
       531
       +
       		config = auth.Config

     

       532
       532
       +
       	} else {

     

       533
       533
       +
       		config = nil

     

       534
       534
       +
       	}

     

       535
       535
       +
       

     

       536
       536
       +
       	var disabledAt interface{}

     

       537
       537
       +
       	if auth.DisabledAt != nil {

     

       538
       538
       +
       		disabledAt = *auth.DisabledAt

     

       539
       539
       +
       	} else {

     

       540
       540
       +
       		disabledAt = nil

     

       541
       541
       +
       	}

     

       542
       542
       +
       

     

       543
       543
       +
       	result, err := r.db.ExecContext(ctx, query,

     

       544
       544
       +
       		auth.AggregatorDID,

     

       545
       545
       +
       		auth.CommunityDID,

     

       546
       546
       +
       		auth.Enabled,

     

       547
       547
       +
       		config,

     

       548
       548
       +
       		auth.CreatedAt,

     

       549
       549
       +
       		nullString(auth.CreatedBy),

     

       550
       550
       +
       		disabledAt,

     

       551
       551
       +
       		nullString(auth.DisabledBy),

     

       552
       552
       +
       		auth.IndexedAt,

     

       553
       553
       +
       		nullString(auth.RecordURI),

     

       554
       554
       +
       		nullString(auth.RecordCID),

     

       555
       555
       +
       	)

     

       556
       556
       +
       

     

       557
       557
       +
       	if err != nil {

     

       558
       558
       +
       		return fmt.Errorf("failed to update authorization: %w", err)

     

       559
       559
       +
       	}

     

       560
       560
       +
       

     

       561
       561
       +
       	rows, err := result.RowsAffected()

     

       562
       562
       +
       	if err != nil {

     

       563
       563
       +
       		return fmt.Errorf("failed to get rows affected: %w", err)

     

       564
       564
       +
       	}

     

       565
       565
       +
       	if rows == 0 {

     

       566
       566
       +
       		return aggregators.ErrAuthorizationNotFound

     

       567
       567
       +
       	}

     

       568
       568
       +
       

     

       569
       569
       +
       	return nil

     

       570
       570
       +
       }

     

       571
       571
       +
       

     

       572
       572
       +
       // DeleteAuthorization removes an authorization

     

       573
       573
       +
       func (r *postgresAggregatorRepo) DeleteAuthorization(ctx context.Context, aggregatorDID, communityDID string) error {

     

       574
       574
       +
       	query := `DELETE FROM aggregator_authorizations WHERE aggregator_did = $1 AND community_did = $2`

     

       575
       575
       +
       

     

       576
       576
       +
       	result, err := r.db.ExecContext(ctx, query, aggregatorDID, communityDID)

     

       577
       577
       +
       	if err != nil {

     

       578
       578
       +
       		return fmt.Errorf("failed to delete authorization: %w", err)

     

       579
       579
       +
       	}

     

       580
       580
       +
       

     

       581
       581
       +
       	rows, err := result.RowsAffected()

     

       582
       582
       +
       	if err != nil {

     

       583
       583
       +
       		return fmt.Errorf("failed to get rows affected: %w", err)

     

       584
       584
       +
       	}

     

       585
       585
       +
       	if rows == 0 {

     

       586
       586
       +
       		return aggregators.ErrAuthorizationNotFound

     

       587
       587
       +
       	}

     

       588
       588
       +
       

     

       589
       589
       +
       	return nil

     

       590
       590
       +
       }

     

       591
       591
       +
       

     

       592
       592
       +
       // DeleteAuthorizationByURI removes an authorization by record URI (for Jetstream delete operations)

     

       593
       593
       +
       func (r *postgresAggregatorRepo) DeleteAuthorizationByURI(ctx context.Context, recordURI string) error {

     

       594
       594
       +
       	query := `DELETE FROM aggregator_authorizations WHERE record_uri = $1`

     

       595
       595
       +
       

     

       596
       596
       +
       	result, err := r.db.ExecContext(ctx, query, recordURI)

     

       597
       597
       +
       	if err != nil {

     

       598
       598
       +
       		return fmt.Errorf("failed to delete authorization by URI: %w", err)

     

       599
       599
       +
       	}

     

       600
       600
       +
       

     

       601
       601
       +
       	rows, err := result.RowsAffected()

     

       602
       602
       +
       	if err != nil {

     

       603
       603
       +
       		return fmt.Errorf("failed to get rows affected: %w", err)

     

       604
       604
       +
       	}

     

       605
       605
       +
       	if rows == 0 {

     

       606
       606
       +
       		return aggregators.ErrAuthorizationNotFound

     

       607
       607
       +
       	}

     

       608
       608
       +
       

     

       609
       609
       +
       	return nil

     

       610
       610
       +
       }

     

       611
       611
       +
       

     

       612
       612
       +
       // ===== Authorization Query Operations =====

     

       613
       613
       +
       

     

       614
       614
       +
       // ListAuthorizationsForAggregator retrieves all communities that authorized an aggregator

     

       615
       615
       +
       func (r *postgresAggregatorRepo) ListAuthorizationsForAggregator(ctx context.Context, aggregatorDID string, enabledOnly bool, limit, offset int) ([]*aggregators.Authorization, error) {

     

       616
       616
       +
       	baseQuery := `

     

       617
       617
       +
       		SELECT

     

       618
       618
       +
       			id, aggregator_did, community_did, enabled, config,

     

       619
       619
       +
       			created_at, created_by, disabled_at, disabled_by,

     

       620
       620
       +
       			indexed_at, record_uri, record_cid

     

       621
       621
       +
       		FROM aggregator_authorizations

     

       622
       622
       +
       		WHERE aggregator_did = $1`

     

       623
       623
       +
       

     

       624
       624
       +
       	var query string

     

       625
       625
       +
       	var args []interface{}

     

       626
       626
       +
       

     

       627
       627
       +
       	if enabledOnly {

     

       628
       628
       +
       		query = baseQuery + ` AND enabled = true ORDER BY created_at DESC LIMIT $2 OFFSET $3`

     

       629
       629
       +
       		args = []interface{}{aggregatorDID, limit, offset}

     

       630
       630
       +
       	} else {

     

       631
       631
       +
       		query = baseQuery + ` ORDER BY created_at DESC LIMIT $2 OFFSET $3`

     

       632
       632
       +
       		args = []interface{}{aggregatorDID, limit, offset}

     

       633
       633
       +
       	}

     

       634
       634
       +
       

     

       635
       635
       +
       	rows, err := r.db.QueryContext(ctx, query, args...)

     

       636
       636
       +
       	if err != nil {

     

       637
       637
       +
       		return nil, fmt.Errorf("failed to list authorizations for aggregator: %w", err)

     

       638
       638
       +
       	}

     

       639
       639
       +
       	defer rows.Close()

     

       640
       640
       +
       

     

       641
       641
       +
       	return scanAuthorizations(rows)

     

       642
       642
       +
       }

     

       643
       643
       +
       

     

       644
       644
       +
       // ListAuthorizationsForCommunity retrieves all aggregators authorized by a community

     

       645
       645
       +
       func (r *postgresAggregatorRepo) ListAuthorizationsForCommunity(ctx context.Context, communityDID string, enabledOnly bool, limit, offset int) ([]*aggregators.Authorization, error) {

     

       646
       646
       +
       	baseQuery := `

     

       647
       647
       +
       		SELECT

     

       648
       648
       +
       			id, aggregator_did, community_did, enabled, config,

     

       649
       649
       +
       			created_at, created_by, disabled_at, disabled_by,

     

       650
       650
       +
       			indexed_at, record_uri, record_cid

     

       651
       651
       +
       		FROM aggregator_authorizations

     

       652
       652
       +
       		WHERE community_did = $1`

     

       653
       653
       +
       

     

       654
       654
       +
       	var query string

     

       655
       655
       +
       	var args []interface{}

     

       656
       656
       +
       

     

       657
       657
       +
       	if enabledOnly {

     

       658
       658
       +
       		query = baseQuery + ` AND enabled = true ORDER BY created_at DESC LIMIT $2 OFFSET $3`

     

       659
       659
       +
       		args = []interface{}{communityDID, limit, offset}

     

       660
       660
       +
       	} else {

     

       661
       661
       +
       		query = baseQuery + ` ORDER BY created_at DESC LIMIT $2 OFFSET $3`

     

       662
       662
       +
       		args = []interface{}{communityDID, limit, offset}

     

       663
       663
       +
       	}

     

       664
       664
       +
       

     

       665
       665
       +
       	rows, err := r.db.QueryContext(ctx, query, args...)

     

       666
       666
       +
       	if err != nil {

     

       667
       667
       +
       		return nil, fmt.Errorf("failed to list authorizations for community: %w", err)

     

       668
       668
       +
       	}

     

       669
       669
       +
       	defer rows.Close()

     

       670
       670
       +
       

     

       671
       671
       +
       	return scanAuthorizations(rows)

     

       672
       672
       +
       }

     

       673
       673
       +
       

     

       674
       674
       +
       // IsAuthorized performs a fast authorization check (enabled=true)

     

       675
       675
       +
       // Uses the optimized partial index: idx_aggregator_auth_enabled

     

       676
       676
       +
       func (r *postgresAggregatorRepo) IsAuthorized(ctx context.Context, aggregatorDID, communityDID string) (bool, error) {

     

       677
       677
       +
       	query := `

     

       678
       678
       +
       		SELECT EXISTS(

     

       679
       679
       +
       			SELECT 1 FROM aggregator_authorizations

     

       680
       680
       +
       			WHERE aggregator_did = $1 AND community_did = $2 AND enabled = true

     

       681
       681
       +
       		)`

     

       682
       682
       +
       

     

       683
       683
       +
       	var authorized bool

     

       684
       684
       +
       	err := r.db.QueryRowContext(ctx, query, aggregatorDID, communityDID).Scan(&authorized)

     

       685
       685
       +
       	if err != nil {

     

       686
       686
       +
       		return false, fmt.Errorf("failed to check authorization: %w", err)

     

       687
       687
       +
       	}

     

       688
       688
       +
       

     

       689
       689
       +
       	return authorized, nil

     

       690
       690
       +
       }

     

       691
       691
       +
       

     

       692
       692
       +
       // ===== Post Tracking Operations =====

     

       693
       693
       +
       

     

       694
       694
       +
       // RecordAggregatorPost tracks a post created by an aggregator (for rate limiting and stats)

     

       695
       695
       +
       func (r *postgresAggregatorRepo) RecordAggregatorPost(ctx context.Context, aggregatorDID, communityDID, postURI, postCID string) error {

     

       696
       696
       +
       	query := `

     

       697
       697
       +
       		INSERT INTO aggregator_posts (aggregator_did, community_did, post_uri, post_cid, created_at)

     

       698
       698
       +
       		VALUES ($1, $2, $3, $4, NOW())`

     

       699
       699
       +
       

     

       700
       700
       +
       	_, err := r.db.ExecContext(ctx, query, aggregatorDID, communityDID, postURI, postCID)

     

       701
       701
       +
       	if err != nil {

     

       702
       702
       +
       		return fmt.Errorf("failed to record aggregator post: %w", err)

     

       703
       703
       +
       	}

     

       704
       704
       +
       

     

       705
       705
       +
       	return nil

     

       706
       706
       +
       }

     

       707
       707
       +
       

     

       708
       708
       +
       // CountRecentPosts counts posts created by an aggregator in a community since a given time

     

       709
       709
       +
       // Uses the optimized index: idx_aggregator_posts_rate_limit

     

       710
       710
       +
       func (r *postgresAggregatorRepo) CountRecentPosts(ctx context.Context, aggregatorDID, communityDID string, since time.Time) (int, error) {

     

       711
       711
       +
       	query := `

     

       712
       712
       +
       		SELECT COUNT(*)

     

       713
       713
       +
       		FROM aggregator_posts

     

       714
       714
       +
       		WHERE aggregator_did = $1 AND community_did = $2 AND created_at >= $3`

     

       715
       715
       +
       

     

       716
       716
       +
       	var count int

     

       717
       717
       +
       	err := r.db.QueryRowContext(ctx, query, aggregatorDID, communityDID, since).Scan(&count)

     

       718
       718
       +
       	if err != nil {

     

       719
       719
       +
       		return 0, fmt.Errorf("failed to count recent posts: %w", err)

     

       720
       720
       +
       	}

     

       721
       721
       +
       

     

       722
       722
       +
       	return count, nil

     

       723
       723
       +
       }

     

       724
       724
       +
       

     

       725
       725
       +
       // GetRecentPosts retrieves recent posts created by an aggregator in a community

     

       726
       726
       +
       func (r *postgresAggregatorRepo) GetRecentPosts(ctx context.Context, aggregatorDID, communityDID string, since time.Time) ([]*aggregators.AggregatorPost, error) {

     

       727
       727
       +
       	query := `

     

       728
       728
       +
       		SELECT id, aggregator_did, community_did, post_uri, created_at

     

       729
       729
       +
       		FROM aggregator_posts

     

       730
       730
       +
       		WHERE aggregator_did = $1 AND community_did = $2 AND created_at >= $3

     

       731
       731
       +
       		ORDER BY created_at DESC`

     

       732
       732
       +
       

     

       733
       733
       +
       	rows, err := r.db.QueryContext(ctx, query, aggregatorDID, communityDID, since)

     

       734
       734
       +
       	if err != nil {

     

       735
       735
       +
       		return nil, fmt.Errorf("failed to get recent posts: %w", err)

     

       736
       736
       +
       	}

     

       737
       737
       +
       	defer rows.Close()

     

       738
       738
       +
       

     

       739
       739
       +
       	var posts []*aggregators.AggregatorPost

     

       740
       740
       +
       	for rows.Next() {

     

       741
       741
       +
       		post := &aggregators.AggregatorPost{}

     

       742
       742
       +
       		err := rows.Scan(

     

       743
       743
       +
       			&post.ID,

     

       744
       744
       +
       			&post.AggregatorDID,

     

       745
       745
       +
       			&post.CommunityDID,

     

       746
       746
       +
       			&post.PostURI,

     

       747
       747
       +
       			&post.CreatedAt,

     

       748
       748
       +
       		)

     

       749
       749
       +
       		if err != nil {

     

       750
       750
       +
       			return nil, fmt.Errorf("failed to scan aggregator post: %w", err)

     

       751
       751
       +
       		}

     

       752
       752
       +
       		posts = append(posts, post)

     

       753
       753
       +
       	}

     

       754
       754
       +
       

     

       755
       755
       +
       	if err = rows.Err(); err != nil {

     

       756
       756
       +
       		return nil, fmt.Errorf("error iterating aggregator posts: %w", err)

     

       757
       757
       +
       	}

     

       758
       758
       +
       

     

       759
       759
       +
       	return posts, nil

     

       760
       760
       +
       }

     

       761
       761
       +
       

     

       762
       762
       +
       // ===== Helper Functions =====

     

       763
       763
       +
       

     

       764
       764
       +
       // scanAuthorizations is a helper to scan multiple authorization rows

     

       765
       765
       +
       func scanAuthorizations(rows *sql.Rows) ([]*aggregators.Authorization, error) {

     

       766
       766
       +
       	var auths []*aggregators.Authorization

     

       767
       767
       +
       

     

       768
       768
       +
       	for rows.Next() {

     

       769
       769
       +
       		auth := &aggregators.Authorization{}

     

       770
       770
       +
       		var config []byte

     

       771
       771
       +
       		var createdBy, disabledBy, recordURI, recordCID sql.NullString

     

       772
       772
       +
       		var disabledAt sql.NullTime

     

       773
       773
       +
       

     

       774
       774
       +
       		err := rows.Scan(

     

       775
       775
       +
       			&auth.ID,

     

       776
       776
       +
       			&auth.AggregatorDID,

     

       777
       777
       +
       			&auth.CommunityDID,

     

       778
       778
       +
       			&auth.Enabled,

     

       779
       779
       +
       			&config,

     

       780
       780
       +
       			&auth.CreatedAt,

     

       781
       781
       +
       			&createdBy,

     

       782
       782
       +
       			&disabledAt,

     

       783
       783
       +
       			&disabledBy,

     

       784
       784
       +
       			&auth.IndexedAt,

     

       785
       785
       +
       			&recordURI,

     

       786
       786
       +
       			&recordCID,

     

       787
       787
       +
       		)

     

       788
       788
       +
       		if err != nil {

     

       789
       789
       +
       			return nil, fmt.Errorf("failed to scan authorization: %w", err)

     

       790
       790
       +
       		}

     

       791
       791
       +
       

     

       792
       792
       +
       		// Map nullable fields

     

       793
       793
       +
       		auth.CreatedBy = createdBy.String

     

       794
       794
       +
       		auth.DisabledBy = disabledBy.String

     

       795
       795
       +
       		if disabledAt.Valid {

     

       796
       796
       +
       			disabledAtVal := disabledAt.Time

     

       797
       797
       +
       			auth.DisabledAt = &disabledAtVal

     

       798
       798
       +
       		}

     

       799
       799
       +
       		auth.RecordURI = recordURI.String

     

       800
       800
       +
       		auth.RecordCID = recordCID.String

     

       801
       801
       +
       		if config != nil {

     

       802
       802
       +
       			auth.Config = config

     

       803
       803
       +
       		}

     

       804
       804
       +
       

     

       805
       805
       +
       		auths = append(auths, auth)

     

       806
       806
       +
       	}

     

       807
       807
       +
       

     

       808
       808
       +
       	if err := rows.Err(); err != nil {

     

       809
       809
       +
       		return nil, fmt.Errorf("error iterating authorizations: %w", err)

     

       810
       810
       +
       	}

     

       811
       811
       +
       

     

       812
       812
       +
       	return auths, nil

     

       813
       813
       +
       }