groups

type Avatar struct {
	Image string `json:"image,omitempty"`
	// Renditions are its public images, filled on reads (Options.Covers).
	Renditions []Rendition `json:"renditions,omitempty"`
}

type CardOptions struct {
	// Language resolves names and paths as ListOptions.Language does.
	Language string
	// Covers fills covers' and avatars' renditions in one call; chips leave
	// them out.
	Covers bool
}

type ContentGroups struct {
	// ContentID names the content; routes take it from the path.
	ContentID string `json:"-"`
	// Kinds limits the write to these group kinds; empty means every group
	// kind the content's kind declares.
	Kinds       []string     `json:"kinds,omitempty"`
	Memberships []Membership `json:"memberships"`
}

type ContentMemberships struct {
	ContentID   string       `json:"content_id"`
	Memberships []Membership `json:"memberships"`
	Groups      []GroupCard  `json:"groups"`
}

type Count struct {
	ContentKind string `json:"content_kind"`
	Language    string `json:"language"`
	Count       int    `json:"count"`
}

type Cover struct {
	Image     string `json:"image,omitempty"`
	ContentID string `json:"content_id,omitempty"`
	Auto      bool   `json:"auto,omitempty"`
	// Renditions are its public images, filled on reads (Options.Covers).
	Renditions []Rendition `json:"renditions,omitempty"`
}

type CoverOf struct {
	Kind   string
	ID     GroupID
	Cover  Cover
	Preset string
}

type CoverResolver interface {
	Covers(ctx context.Context, covers []CoverOf) ([][]Rendition, error)
}

type Edge struct {
	From     GroupID `json:"from"`
	Relation string  `json:"relation"`
	To       GroupID `json:"to"`
}

type EdgeInput struct {
	Relation string  `json:"relation"`
	To       GroupID `json:"to"`
}

type Folders interface {
	ExposeTx(ctx context.Context, tx pgx.Tx, groups []Ref) error
	DeleteTx(ctx context.Context, tx pgx.Tx, groups []Ref) error
}

type Group struct {
	ID   GroupID `json:"id"`
	Kind string  `json:"kind"`
	Slug string  `json:"slug"`
	// ScopeID is the group the slug is unique within (a character's series).
	ScopeID     GroupID        `json:"scope_id,omitempty"`
	ParentID    GroupID        `json:"parent_id,omitempty"`
	State       State          `json:"state"`
	MergedInto  GroupID        `json:"merged_into,omitempty"`
	Attributes  map[string]any `json:"attributes"`
	Cover       *Cover         `json:"cover,omitempty"`
	Avatar      *Avatar        `json:"avatar,omitempty"`
	OwnerUserID string         `json:"owner_user_id,omitempty"`
	// AuthScope is the AuthKit group whose holders of
	// access.GroupSettingsManage edit it; ContentKit provisions it for a
	// kind with auth_scope (Options.Scopes).
	AuthScope string    `json:"auth_scope,omitempty"`
	CreatedAt time.Time `json:"created_at"`
	UpdatedAt time.Time `json:"updated_at"`
	Revision  int64     `json:"revision"`
}

type GroupCard struct {
	ID           GroupID `json:"id"`
	Kind         string  `json:"kind"`
	Slug         string  `json:"slug"`
	ScopeID      GroupID `json:"scope_id,omitempty"`
	ParentID     GroupID `json:"parent_id,omitempty"`
	Name         string  `json:"name"`
	NameLanguage string  `json:"name_language,omitempty"`
	Code         string  `json:"code,omitempty"`
	Path         string  `json:"path,omitempty"`
	Cover        *Cover  `json:"cover,omitempty"`
	// Avatar is a user-owned group's avatar.
	Avatar     *Avatar        `json:"avatar,omitempty"`
	Count      int            `json:"count"`
	Attributes map[string]any `json:"attributes"`
	// Access is a sellable group's sale: its key, active offer and the
	// viewer's standing.
	Access    *offers.GroupAccess `json:"access,omitempty"`
	CreatedAt time.Time           `json:"created_at"`
}

type GroupDetail struct {
	Group
	Name         string      `json:"name"`
	NameLanguage string      `json:"name_language,omitempty"`
	Code         string      `json:"code,omitempty"`
	Path         string      `json:"path,omitempty"`
	Names        []Name      `json:"names"`
	Text         []Text      `json:"text"`
	Parent       *GroupCard  `json:"parent,omitempty"`
	Scope        *GroupCard  `json:"scope,omitempty"`
	Children     []GroupCard `json:"children"`
	Edges        []Edge      `json:"edges"`
	Counts       []Count     `json:"counts"`
	// Access is a sellable group's sale: its key, active offer and the
	// viewer's standing.
	Access *offers.GroupAccess `json:"access,omitempty"`
	// Offer is a sellable group's current offer, for its offer editors.
	Offer *offers.Offer `json:"offer,omitempty"`
}

type GroupID = contentref.GroupID

type GroupInput struct {
	// ID is optional; omitted ids are generated.
	ID   GroupID `json:"id,omitempty"`
	Kind string  `json:"kind"`
	Slug string  `json:"slug"`
	// ScopeID is required for a kind scoped by another (a character's series).
	ScopeID    GroupID        `json:"scope_id,omitempty"`
	ParentID   GroupID        `json:"parent_id,omitempty"`
	Attributes map[string]any `json:"attributes,omitempty"`
	Cover      *Cover         `json:"cover,omitempty"`
	Avatar     *Avatar        `json:"avatar,omitempty"`
	// OwnerUserID owns a user-owned group; a person creating one owns it.
	OwnerUserID string `json:"owner_user_id,omitempty"`
	// AuthScope is staff's (an import's); ContentKit provisions it otherwise.
	AuthScope string `json:"auth_scope,omitempty"`
	Names     []Name `json:"names,omitempty"`
	Text      []Text `json:"text,omitempty"`
}

type GroupNames struct {
	ID    GroupID `json:"id"`
	Names []Name  `json:"names"`
}

type GroupPage struct {
	Groups []GroupCard `json:"groups"`
	// NextCursor pages on; empty on the last page.
	NextCursor string `json:"next_cursor,omitempty"`
}

type GroupUpdate struct {
	// ID names the group; routes take it from the path.
	ID      GroupID  `json:"-"`
	Slug    *string  `json:"slug,omitempty"`
	ScopeID *GroupID `json:"scope_id,omitempty"`
	// ParentID "" detaches the group from its parent.
	ParentID *GroupID `json:"parent_id,omitempty"`
	// State restores (active) or deletes a group.
	State *State `json:"state,omitempty"`
	// Attributes replaces every attribute.
	Attributes map[string]any `json:"attributes,omitempty"`
	// Cover selects a cover; an empty one returns to the automatic cover.
	Cover *Cover `json:"cover,omitempty"`
	// Avatar selects a user-owned group's avatar; an empty one returns to
	// the first.
	Avatar      *Avatar `json:"avatar,omitempty"`
	OwnerUserID *string `json:"owner_user_id,omitempty"`
	AuthScope   *string `json:"auth_scope,omitempty"`
	// Names replaces every name and alias.
	Names []Name `json:"names,omitempty"`
	// Text replaces the text of every language.
	Text []Text `json:"text,omitempty"`
}

type ImportGroup struct {
	ID          GroupID
	Kind        string
	Slug        string
	ScopeID     GroupID
	ParentID    GroupID
	State       State
	Attributes  map[string]any
	Cover       *Cover
	Avatar      *Avatar
	OwnerUserID string
	// AuthScope names the group's AuthKit scope; empty keeps the stored one.
	AuthScope string
	Names     []Name
	Text      []Text
	// Edges are the group's edges to others (From is the group).
	Edges     []Edge
	Code      string
	CreatedAt *time.Time
	UpdatedAt *time.Time
}

type ListOptions struct {
	Kind string
	// Parent keeps the children of one group (sub-series of a series).
	Parent GroupID
	// Scope keeps the groups scoped by one group (characters of a series).
	Scope GroupID
	Slug  string
	// Letter keeps groups whose sort name starts with it (a-z), or with
	// anything else ("#").
	Letter string
	// Language resolves names, sort keys and slugs, scopes counts and
	// prefixes paths. Empty: names in the first configured language, counts
	// over every language, unprefixed paths.
	Language string
	// ContentKind scopes counts to one content kind; empty sums them.
	ContentKind string
	Sort        Sort
	// Cursor is the previous page's NextCursor under the same Sort.
	Cursor string
	// Limit defaults to 50 and is capped at 200.
	Limit int
}

type MemberOptions struct {
	// Cursor is the previous page's NextCursor.
	Cursor string
	// Limit defaults to 50 and is capped at 500.
	Limit int
}

type MemberPage struct {
	Members []Membership `json:"members"`
	// NextCursor pages on; empty on the last page.
	NextCursor string `json:"next_cursor,omitempty"`
}

type MemberRef struct {
	ContentID string `json:"content_id"`
	VersionID string `json:"version_id,omitempty"`
}

type Membership struct {
	GroupID     GroupID         `json:"group_id,omitempty"`
	ContentID   string          `json:"content_id,omitempty"`
	VersionID   string          `json:"version_id,omitempty"`
	Role        string          `json:"role,omitempty"`
	Position    *int            `json:"position,omitempty"`
	ActiveFrom  *time.Time      `json:"active_from,omitempty"`
	ActiveUntil *time.Time      `json:"active_until,omitempty"`
	State       MembershipState `json:"state,omitempty"`
}

type MembershipState string

type Merge struct {
	From GroupID `json:"from"`
	Into GroupID `json:"into"`
}

type MergeInput struct {
	Into GroupID `json:"into"`
}

type MergeReport struct {
	From             GroupID `json:"from"`
	Into             GroupID `json:"into"`
	MembershipsMoved int64   `json:"memberships_moved"`
	NamesMoved       int64   `json:"names_moved"`
	EdgesMoved       int64   `json:"edges_moved"`
	GroupsMoved      int64   `json:"groups_moved"`
}

type MyGroup struct {
	GroupCard
	// Owner: the viewer owns it.
	Owner bool `json:"owner"`
	// Editor: the viewer holds its kind's access.GroupSettingsManage in its
	// AuthKit scope.
	Editor bool `json:"editor"`
	// Writer: the viewer holds its kind's access.GroupContentWrite there.
	Writer bool `json:"writer"`
	// Moderator: the viewer holds its kind's access.GroupCommentsModerate
	// there, or owns it.
	Moderator bool `json:"moderator"`
	// Member: the viewer holds its key.
	Member bool `json:"member"`
}

type MyGroupPage struct {
	Groups     []MyGroup `json:"groups"`
	NextCursor string    `json:"next_cursor,omitempty"`
}

type Name struct {
	Language string   `json:"language"`
	Kind     NameKind `json:"kind"`
	Name     string   `json:"name"`
}

type NameKind string

type Options struct {
	Pool   *pgxpool.Pool
	Schema string
	Tenant string
	// Kinds is the site's content model; its GroupKinds govern every write.
	Kinds kinds.Config
	// ContentChanged runs in the writing transaction whenever the effective
	// groups of contents may have changed (their facets' group_ids are
	// already re-derived), so the engine can rebuild what else depends on
	// them, such as search documents. Optional.
	ContentChanged func(ctx context.Context, q Querier, contentIDs []string) error
	// DocumentsChanged runs in the writing transaction after a write queued
	// search documents, so the engine can sync them at once. Optional.
	DocumentsChanged func(ctx context.Context, q Querier) error
	// Covers fills covers' and avatars' renditions on reads. Optional.
	Covers CoverResolver
	// Sales fills sellable groups' offers and the viewer's standing on
	// reads: offers.Service. Optional.
	Sales Sales
	// Scopes provisions and retires the AuthKit scopes of auth_scope kinds,
	// and lists a person's. Optional: without it auth_scope is whatever staff
	// set.
	Scopes Scopes
	// Folders hides a deleted group's media and shows it again on restore,
	// in the writing transaction, and purges a user-owned group's once it
	// stayed deleted for DeletedRetention: media/versions.Service.GroupFolders.
	// Optional.
	Folders Folders
	// DeletedRetention is how long a deleted user-owned group keeps its media
	// for a restore; zero is DefaultDeletedRetention.
	DeletedRetention time.Duration
	// Owned deletes the content a deleted user-owned group owns
	// (owner_group) and restores it with the group: the catalog. Optional.
	Owned OwnedContent
	// Queue is the River queue of group syncs; contentkit_groups when empty.
	Queue string
	// Logger receives the HTTP API's failures. nil -> slog.Default().
	Logger *slog.Logger
}

type Order struct {
	// GroupID names the group; routes take it from the path.
	GroupID GroupID     `json:"-"`
	Members []MemberRef `json:"members"`
}

type OwnedContent interface {
	// DeleteOwned deletes the live content of the deleted ones among groups,
	// recording each group as its content's cause; bought content stays
	// readable to its buyers.
	DeleteOwned(ctx context.Context, groups []string) error
	// RestoreOwned restores the content the active ones among groups
	// deleted when they were, unless it was purged since; content deleted
	// for another reason stays deleted.
	RestoreOwned(ctx context.Context, groups []string) error
}

type Querier interface {
	Exec(ctx context.Context, sql string, args ...any) (pgconn.CommandTag, error)
	Query(ctx context.Context, sql string, args ...any) (pgx.Rows, error)
	QueryRow(ctx context.Context, sql string, args ...any) pgx.Row
}

type Ref struct {
	Kind string
	ID   GroupID
}

type Rendition struct {
	URL string `json:"url"`
	W   int    `json:"w"`
	H   int    `json:"h"`
}

type Sales interface {
	GroupAccess(ctx context.Context, viewer access.Actor, groups []string) ([]offers.GroupAccess, error)
	Joined(ctx context.Context, viewer access.Actor) ([]string, error)
	Current(ctx context.Context, a auth.Authenticator, actor access.Actor, targets []offers.Target) ([]*offers.Offer, error)
	Resync(ctx context.Context, tx pgx.Tx, targets []offers.Target) error
}

type Scope struct {
	ID    string
	Kind  string
	Owner string
}

type Scopes interface {
	// Provision makes each scope a live AuthKit group of its kind's persona,
	// seeded with Owner as its owner when new; a scope retired before is
	// replaced by a new group under the same id.
	Provision(ctx context.Context, scopes []Scope) error
	// Retire stops each scope resolving and granting.
	Retire(ctx context.Context, ids []string) error
	// Holding answers, per live scope of the kinds' personas user belongs
	// to, the kind's access.GroupPermissions user holds there.
	Holding(ctx context.Context, user string, kinds []string) (map[string][]string, error)
}

type Sort string

type State string

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

type Text struct {
	Language    string `json:"language"`
	Description string `json:"description,omitempty"`
	SortKey     string `json:"sort_key,omitempty"`
}

type Written struct {
	Count int `json:"count"`
}