consent

type Consent struct {
	ID        id.ConsentID `json:"id"`
	UserID    id.UserID    `json:"user_id"`
	AppID     id.AppID     `json:"app_id"`
	Purpose   string       `json:"purpose"`              // e.g. "marketing", "analytics", "essential"
	Granted   bool         `json:"granted"`              // true = granted, false = revoked
	Version   string       `json:"version"`              // policy version this consent applies to
	IPAddress string       `json:"ip_address"`           // IP at time of consent action
	GrantedAt time.Time    `json:"granted_at"`           // when consent was granted
	RevokedAt *time.Time   `json:"revoked_at,omitempty"` // when consent was revoked (nil if active)
	CreatedAt time.Time    `json:"created_at"`
	UpdatedAt time.Time    `json:"updated_at"`
}

type GrantConsentRequest struct {
	AppID   string `json:"app_id,omitempty" description:"Application ID"`
	Purpose string `json:"purpose" description:"Consent purpose (e.g. marketing, analytics, essential)"`
	Version string `json:"version,omitempty" description:"Policy version this consent applies to"`
}

type ListConsentsRequest struct {
	Purpose string `query:"purpose" description:"Filter by consent purpose"`
	Cursor  string `query:"cursor" description:"Pagination cursor"`
	Limit   int    `query:"limit" description:"Maximum number of results (default 50, max 200)"`
}

type ListResponse struct {
	Consents   []*Consent `json:"consents" description:"List of consent records"`
	NextCursor string     `json:"next_cursor,omitempty" description:"Pagination cursor for next page"`
}

type MemoryStore struct {
	// contains filtered or unexported fields
}

type MongoStore struct {
	// contains filtered or unexported fields
}

type Plugin struct {
	// contains filtered or unexported fields
}

type PostgresStore struct {
	// contains filtered or unexported fields
}

type Query struct {
	UserID  id.UserID `json:"user_id"`
	AppID   id.AppID  `json:"app_id"`
	Purpose string    `json:"purpose,omitempty"`
	Cursor  string    `json:"cursor,omitempty"`
	Limit   int       `json:"limit,omitempty"`
}

type RevokeConsentRequest struct {
	AppID   string `json:"app_id,omitempty" description:"Application ID"`
	Purpose string `json:"purpose" description:"Consent purpose to revoke"`
}

type SqliteStore struct {
	// contains filtered or unexported fields
}

type StatusResponse struct {
	Status string `json:"status" description:"Operation status"`
}

type Store interface {
	// GrantConsent records or updates a consent grant for a specific purpose.
	// If a consent record already exists for the user+app+purpose combination,
	// it is updated rather than duplicated.
	GrantConsent(ctx context.Context, c *Consent) error

	// RevokeConsent marks a consent as revoked by setting RevokedAt and Granted=false.
	RevokeConsent(ctx context.Context, userID id.UserID, appID id.AppID, purpose string) error

	// GetConsent returns a specific consent record by user, app, and purpose.
	GetConsent(ctx context.Context, userID id.UserID, appID id.AppID, purpose string) (*Consent, error)

	// ListConsents returns all consent records matching the query.
	ListConsents(ctx context.Context, q *Query) ([]*Consent, string, error)

	// AnonymizeUserConsents keeps a deleted user's consent rows as proof of
	// what was granted and when, but replaces each recorded address with
	// its network so the rows stop identifying a device. It reports how
	// many rows changed.
	AnonymizeUserConsents(ctx context.Context, userID id.UserID) (int64, error)
}