groups

Oct 18, 2026

Changes in this version

type Store

+ func (s *Store) LockHierarchyShared(ctx context.Context, q Querier) error

Oct 18, 2026

Changes in this version

+ const NameSeparators

type ContentGroups

+ Create []NewEntity

type GroupPage

+ Total *int

type ListOptions

+ Deleted bool

+ Page int

+ type NewEntity struct

+ Kind string

+ Language string

+ Name string

type Options

+ References References

+ type References interface

+ CheckUnavailable func(ctx context.Context, q Querier, tenant string, refs []Ref) error

+ Merge func(ctx context.Context, q Querier, tenant string, from, into Ref) error

type Store

+ func (s *Store) ContentEditorGroups(ctx context.Context, a auth.Authenticator, actor access.Actor) ([]GroupID, error)

+ func (s *Store) LockNames(ctx context.Context, q Querier) error

+ func (s *Store) LockReferencesTx(ctx context.Context, tx pgx.Tx, refs []Ref) error

+ func (s *Store) MatchName(ctx context.Context, q Querier, kind, scopeID, language, name string) ([]string, error)

Oct 16, 2026

Changes in this version

type CardOptions

+ IncludeInternal bool

type Group

+ Internal bool

type GroupCard

+ Internal bool

type GroupInput

+ Internal bool

type GroupUpdate

+ Internal *bool

type ImportGroup

+ Internal *bool

type ListOptions

+ IncludeInternal bool

+ Query string

type Store

+ func (s *Store) ManagementDetail(ctx context.Context, id GroupID, language string) (GroupDetail, error)

Oct 16, 2026

Changes in this version

type Store

+ func (s *Store) CreateGroupsTx(ctx context.Context, tx pgx.Tx, in []GroupInput) ([]Group, error)

+ func (s *Store) PrepareStaffWrite(ctx context.Context) (bool, error)

+ func (s *Store) SetContentGroupsTx(ctx context.Context, tx pgx.Tx, in []ContentGroups) error

Oct 15, 2026

Changes in this version

+ type AppBinding interface

+ ContentKitScope func() (tenantID, appID string)

+ type LocalScopes interface

+ HoldingScopes func(ctx context.Context, user string, kinds, scopeIDs []string) (map[string][]string, error)

Oct 14, 2026

Changes in this version

type CoverOf

+ Language string

Oct 13, 2026

Changes in this version

type Store

+ func (s *Store) ImportDeletes(ctx context.Context, q pgx.Tx, ids []GroupID) error

Oct 13, 2026

Changes in this version

type GroupDetail

+ Offer *offers.Offer

type Sales

+ Current func(ctx context.Context, a auth.Authenticator, actor access.Actor, ...) ([]*offers.Offer, error)

Oct 13, 2026

Changes in this version

+ const AvatarPreset

+ const DefaultDeletedRetention

+ const ReconcileInterval

+ var ErrConflict = errors.New("groups: conflict")

+ var ErrForbidden = errors.New("groups: forbidden")

+ var ErrInvalid = errors.New("groups: invalid input")

+ var ErrLimit = errors.New("groups: limit reached")

+ var ErrNotFound = errors.New("groups: not found")

+ type Avatar struct

+ Image string

+ Renditions []Rendition

+ type CardOptions struct

+ Covers bool

+ Language string

+ type ContentGroups struct

+ ContentID string

+ Kinds []string

+ Memberships []Membership

+ type ContentMemberships struct

+ ContentID string

+ Groups []GroupCard

+ Memberships []Membership

+ type Count struct

+ ContentKind string

+ Count int

+ Language string

+ type Cover struct

+ Auto bool

+ ContentID string

+ Image string

+ Renditions []Rendition

+ type CoverOf struct

+ Cover Cover

+ ID GroupID

+ Kind string

+ Preset string

+ type CoverResolver interface

+ Covers func(ctx context.Context, covers []CoverOf) ([][]Rendition, error)

+ type Edge struct

+ From GroupID

+ Relation string

+ To GroupID

+ type EdgeInput struct

+ Relation string

+ To GroupID

+ type Folders interface

+ DeleteTx func(ctx context.Context, tx pgx.Tx, groups []Ref) error

+ ExposeTx func(ctx context.Context, tx pgx.Tx, groups []Ref) error

+ type Group struct

+ Attributes map[string]any

+ AuthScope string

+ Avatar *Avatar

+ Cover *Cover

+ CreatedAt time.Time

+ ID GroupID

+ Kind string

+ MergedInto GroupID

+ OwnerUserID string

+ ParentID GroupID

+ Revision int64

+ ScopeID GroupID

+ Slug string

+ State State

+ UpdatedAt time.Time

+ type GroupCard struct

+ Access *offers.GroupAccess

+ Attributes map[string]any

+ Avatar *Avatar

+ Code string

+ Count int

+ Cover *Cover

+ CreatedAt time.Time

+ ID GroupID

+ Kind string

+ Name string

+ NameLanguage string

+ ParentID GroupID

+ Path string

+ ScopeID GroupID

+ Slug string

+ type GroupDetail struct

+ Access *offers.GroupAccess

+ Children []GroupCard

+ Code string

+ Counts []Count

+ Edges []Edge

+ Name string

+ NameLanguage string

+ Names []Name

+ Parent *GroupCard

+ Path string

+ Scope *GroupCard

+ Text []Text

+ type GroupID = contentref.GroupID

+ type GroupInput struct

+ Attributes map[string]any

+ AuthScope string

+ Avatar *Avatar

+ Cover *Cover

+ ID GroupID

+ Kind string

+ Names []Name

+ OwnerUserID string

+ ParentID GroupID

+ ScopeID GroupID

+ Slug string

+ Text []Text

+ type GroupNames struct

+ ID GroupID

+ Names []Name

+ type GroupPage struct

+ Groups []GroupCard

+ NextCursor string

+ type GroupUpdate struct

+ Attributes map[string]any

+ AuthScope *string

+ Avatar *Avatar

+ Cover *Cover

+ ID GroupID

+ Names []Name

+ OwnerUserID *string

+ ParentID *GroupID

+ ScopeID *GroupID

+ Slug *string

+ State *State

+ Text []Text

+ type ImportGroup struct

+ Attributes map[string]any

+ AuthScope string

+ Avatar *Avatar

+ Code string

+ Cover *Cover

+ CreatedAt *time.Time

+ Edges []Edge

+ ID GroupID

+ Kind string

+ Names []Name

+ OwnerUserID string

+ ParentID GroupID

+ ScopeID GroupID

+ Slug string

+ State State

+ Text []Text

+ UpdatedAt *time.Time

+ type ListOptions struct

+ ContentKind string

+ Cursor string

+ Kind string

+ Language string

+ Letter string

+ Limit int

+ Parent GroupID

+ Scope GroupID

+ Slug string

+ Sort Sort

+ type MemberOptions struct

+ Cursor string

+ Limit int

+ type MemberPage struct

+ Members []Membership

+ NextCursor string

+ type MemberRef struct

+ ContentID string

+ VersionID string

+ type Membership struct

+ ActiveFrom *time.Time

+ ActiveUntil *time.Time

+ ContentID string

+ GroupID GroupID

+ Position *int

+ Role string

+ State MembershipState

+ VersionID string

+ type MembershipState string

+ const MembershipActive

+ const MembershipProposed

+ type Merge struct

+ From GroupID

+ Into GroupID

+ type MergeInput struct

+ Into GroupID

+ type MergeReport struct

+ EdgesMoved int64

+ From GroupID

+ GroupsMoved int64

+ Into GroupID

+ MembershipsMoved int64

+ NamesMoved int64

+ type MyGroup struct

+ Editor bool

+ Member bool

+ Moderator bool

+ Owner bool

+ Writer bool

+ type MyGroupPage struct

+ Groups []MyGroup

+ NextCursor string

+ type Name struct

+ Kind NameKind

+ Language string

+ Name string

+ type NameKind string

+ const NameAlias

+ const NameCanonical

+ type Options struct

+ ContentChanged func(ctx context.Context, q Querier, contentIDs []string) error

+ Covers CoverResolver

+ DeletedRetention time.Duration

+ DocumentsChanged func(ctx context.Context, q Querier) error

+ Folders Folders

+ Kinds kinds.Config

+ Logger *slog.Logger

+ Owned OwnedContent

+ Pool *pgxpool.Pool

+ Queue string

+ Sales Sales

+ Schema string

+ Scopes Scopes

+ Tenant string

+ type Order struct

+ GroupID GroupID

+ Members []MemberRef

+ type OwnedContent interface

+ DeleteOwned func(ctx context.Context, groups []string) error

+ RestoreOwned func(ctx context.Context, groups []string) error

+ type Querier interface

+ Exec func(ctx context.Context, sql string, args ...any) (pgconn.CommandTag, error)

+ Query func(ctx context.Context, sql string, args ...any) (pgx.Rows, error)

+ QueryRow func(ctx context.Context, sql string, args ...any) pgx.Row

+ type Ref struct

+ ID GroupID

+ Kind string

+ type Rendition struct

+ H int

+ URL string

+ W int

+ type Sales interface

+ GroupAccess func(ctx context.Context, viewer access.Actor, groups []string) ([]offers.GroupAccess, error)

+ Joined func(ctx context.Context, viewer access.Actor) ([]string, error)

+ Resync func(ctx context.Context, tx pgx.Tx, targets []offers.Target) error

+ type Scope struct

+ ID string

+ Kind string

+ Owner string

+ type Scopes interface

+ Holding func(ctx context.Context, user string, kinds []string) (map[string][]string, error)

+ Provision func(ctx context.Context, scopes []Scope) error

+ Retire func(ctx context.Context, ids []string) error

+ type Sort string

+ const SortCount

+ const SortName

+ const SortNewest

+ type State string

+ const StateActive

+ const StateDeleted

+ const StateMerged

+ type Store struct

+ func New(opts Options) (*Store, error)

+ func (s *Store) AddEdges(ctx context.Context, edges []Edge) error

+ func (s *Store) AddMemberships(ctx context.Context, ms []Membership) error

+ func (s *Store) AddNames(ctx context.Context, edits []GroupNames) error

+ func (s *Store) As(a auth.Authenticator, actor access.Actor) *Store

+ func (s *Store) BuildDocuments(ctx context.Context, kind, language string, refs []contentref.ContentRef) ([]search.KeywordDocument, error)

+ func (s *Store) Cards(ctx context.Context, ids []GroupID, o CardOptions) ([]GroupCard, error)

+ func (s *Store) CreateGroups(ctx context.Context, inputs []GroupInput) ([]Group, error)

+ func (s *Store) DeleteGroups(ctx context.Context, ids []GroupID) ([]Group, error)

+ func (s *Store) Detail(ctx context.Context, id GroupID, language string) (GroupDetail, error)

+ func (s *Store) DocumentKinds() []string

+ func (s *Store) EffectiveGroups(ctx context.Context, q Querier, versionIDs []string) (map[string][]string, error)

+ func (s *Store) Groups(ctx context.Context, ids []GroupID) ([]Group, error)

+ func (s *Store) Handler(a auth.Authenticator) (http.Handler, error)

+ func (s *Store) ImportGroups(ctx context.Context, q pgx.Tx, in []ImportGroup, provision bool) error

+ func (s *Store) ImportMemberships(ctx context.Context, q pgx.Tx, sets []ContentGroups) error

+ func (s *Store) List(ctx context.Context, opts ListOptions) (GroupPage, error)

+ func (s *Store) ListDocuments(ctx context.Context, kind, language, cursor string, limit int) ([]contentref.ContentRef, string, bool, error)

+ func (s *Store) Members(ctx context.Context, id GroupID, opts MemberOptions) (MemberPage, error)

+ func (s *Store) Memberships(ctx context.Context, tenant, contentKind, groupKind string, ...) (map[string][]GroupID, error)

+ func (s *Store) MembershipsOf(ctx context.Context, contentIDs []string) (map[string][]Membership, error)

+ func (s *Store) Merge(ctx context.Context, merges []Merge) ([]MergeReport, error)

+ func (s *Store) Mine(ctx context.Context, opts ListOptions) (MyGroupPage, error)

+ func (s *Store) PurgeFolders(ctx context.Context) (int, error)

+ func (s *Store) Reconcile(ctx context.Context) error

+ func (s *Store) Recount(ctx context.Context) error

+ func (s *Store) RefreshWindows(ctx context.Context, lookback time.Duration) error

+ func (s *Store) RemoveEdges(ctx context.Context, edges []Edge) error

+ func (s *Store) RemoveMemberships(ctx context.Context, ms []Membership) error

+ func (s *Store) RemoveNames(ctx context.Context, edits []GroupNames) error

+ func (s *Store) Reorder(ctx context.Context, orders []Order) error

+ func (s *Store) RiverJobs() riverhelpers.Contribution

+ func (s *Store) SetContentGroups(ctx context.Context, sets []ContentGroups) error

+ func (s *Store) SetNames(ctx context.Context, edits []GroupNames) error

+ func (s *Store) Sync(ctx context.Context, ids []GroupID) error

+ func (s *Store) SyncScopes(ctx context.Context, ids []GroupID) error

+ func (s *Store) Tenant() string

+ func (s *Store) UpdateGroups(ctx context.Context, updates []GroupUpdate) ([]Group, error)

+ type Text struct

+ Description string

+ Language string

+ SortKey string

+ type Written struct

+ Count int