organization

type AcceptInvitationParams struct {
	InvitationID string `json:"invitation_id"`
	UserID       string `json:"user_id"`
	plugin.ExtraContainer
}

type AcceptInvitationResult struct {
	Invitation   *Invitation   `json:"invitation"`
	Member       *Member       `json:"member"`
	Organization *Organization `json:"organization"`
}

type AddMemberParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id"`
	Role           string `json:"role"`
	InvokingUserID string `json:"invoking_user_id,omitempty"`
	plugin.ExtraContainer
}

type AddMemberResult struct {
	Member *Member `json:"member"`
}

type AddTeamMemberParams struct {
	TeamID         string `json:"team_id"`
	UserID         string `json:"user_id"`
	InvokingUserID string `json:"invoking_user_id,omitempty"`
	plugin.ExtraContainer
}

type AddTeamMemberResult struct {
	TeamMember *TeamMember `json:"team_member"`
}

type AllowOrgCreationFunc func(ctx context.Context, userID string) (bool, error)

type CancelInvitationParams struct {
	InvitationID string `json:"invitation_id"`
	UserID       string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type CancelInvitationResult struct {
	Invitation *Invitation `json:"invitation"`
}

type CheckSlugParams struct {
	Slug string `json:"slug"`
	plugin.ExtraContainer
}

type CheckSlugResult struct {
	Available bool `json:"available"`
}

type Config struct {
	// AllowUserToCreateOrganization determines whether a user is authorized to create a new organization.
	AllowUserToCreateOrganization AllowOrgCreationFunc

	// OrganizationLimit restricts the maximum number of organizations a user can create.
	OrganizationLimit OrgLimitFunc

	// CreatorRole specifies the initial role assigned to the user creating an organization (default: "owner").
	CreatorRole string

	// MembershipLimit restricts the maximum number of members per organization.
	MembershipLimit MembershipLimitFunc

	// InvitationExpiresIn defines the validity duration for issued member invitations (default: 48 hours).
	InvitationExpiresIn time.Duration

	// InvitationLimit restricts the maximum number of pending invitations per organization.
	InvitationLimit InvitationLimitFunc

	// CancelPendingInvitationsOnReInvite automatically cancels previous pending invitations when re-inviting the same email.
	CancelPendingInvitationsOnReInvite bool

	// RequireEmailVerificationOnInvitation enforces that the invited recipient email must be verified.
	RequireEmailVerificationOnInvitation bool

	// SendInvitationEmail is an optional delivery callback invoked whenever an invitation is created.
	SendInvitationEmail SendInvitationEmailFunc

	// TeamsEnabled enables the sub-module for organizational teams and team memberships.
	TeamsEnabled bool

	// DefaultTeamEnabled automatically creates an initial default team upon organization creation.
	DefaultTeamEnabled bool

	// AllowRemovingAllTeams permits deleting all teams in an organization (default: true).
	AllowRemovingAllTeams bool

	// MaximumTeams restricts the maximum number of teams per organization.
	MaximumTeams MaxTeamsFunc

	// MaximumMembersPerTeam restricts the maximum number of members per team.
	MaximumMembersPerTeam MaxMembersPerTeamFunc

	// DynamicAccessControlEnabled enables database-persisted dynamic roles and custom permission matrices.
	DynamicAccessControlEnabled bool

	// MaximumRolesPerOrganization restricts the maximum number of dynamic roles per organization.
	MaximumRolesPerOrganization MaxRolesFunc

	// CustomRoles defines static custom roles and their granted permission matrices.
	CustomRoles map[string]Permissions
}

type CreateInvitationParams struct {
	OrganizationID string  `json:"organization_id"`
	InviterID      string  `json:"inviter_id"`
	Email          string  `json:"email"`
	Role           string  `json:"role"`
	TeamID         *string `json:"team_id,omitempty"`
	plugin.ExtraContainer
}

type CreateInvitationResult struct {
	Invitation *Invitation `json:"invitation"`
}

type CreateOrganizationParams struct {
	UserID   string         `json:"user_id"`
	Name     string         `json:"name"`
	Slug     string         `json:"slug,omitempty"`
	Logo     string         `json:"logo,omitempty"`
	Metadata map[string]any `json:"metadata,omitempty"`
	plugin.ExtraContainer
}

type CreateOrganizationResult struct {
	Organization *Organization `json:"organization"`
	Member       *Member       `json:"member"`
}

type CreateRoleParams struct {
	OrganizationID string              `json:"organization_id"`
	UserID         string              `json:"user_id,omitempty"`
	Role           string              `json:"role"`
	Permissions    map[string][]string `json:"permissions"`
	plugin.ExtraContainer
}

type CreateRoleResult struct {
	Role *OrganizationRole `json:"role"`
}

type CreateTeamParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id,omitempty"`
	Name           string `json:"name"`
	plugin.ExtraContainer
}

type CreateTeamResult struct {
	Team *Team `json:"team"`
}

type DeleteOrganizationParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type DeleteOrganizationResult struct {
	Success bool `json:"success"`
}

type DeleteRoleParams struct {
	RoleID string `json:"role_id"`
	UserID string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type DeleteRoleResult struct {
	Success bool `json:"success"`
}

type DeleteTeamParams struct {
	TeamID string `json:"team_id"`
	UserID string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type DeleteTeamResult struct {
	Success bool `json:"success"`
}

type GetActiveMemberParams struct {
	UserID         string `json:"user_id"`
	OrganizationID string `json:"organization_id,omitempty"`
	plugin.ExtraContainer
}

type GetActiveMemberResult struct {
	Member *Member `json:"member"`
}

type GetActiveMemberRoleParams struct {
	UserID         string `json:"user_id"`
	OrganizationID string `json:"organization_id,omitempty"`
	plugin.ExtraContainer
}

type GetActiveMemberRoleResult struct {
	Role string `json:"role"`
}

type GetActiveOrganizationParams struct {
	UserID string `json:"user_id"`
	plugin.ExtraContainer
}

type GetActiveOrganizationResult struct {
	Organization *Organization `json:"organization"`
	Member       *Member       `json:"member"`
}

type GetActiveTeamParams struct {
	UserID string `json:"user_id"`
	plugin.ExtraContainer
}

type GetActiveTeamResult struct {
	Team *Team `json:"team"`
}

type GetFullOrganizationParams struct {
	OrganizationID string `json:"organization_id"`
	plugin.ExtraContainer
}

type GetFullOrganizationResult struct {
	Organization *Organization `json:"organization"`
	Members      []*Member     `json:"members"`
	Invitations  []*Invitation `json:"invitations"`
	Teams        []*Team       `json:"teams,omitempty"`
}

type GetInvitationParams struct {
	InvitationID string `json:"invitation_id"`
	plugin.ExtraContainer
}

type GetInvitationResult struct {
	Invitation *Invitation `json:"invitation"`
}

type GetMemberParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id"`
	plugin.ExtraContainer
}

type GetMemberResult struct {
	Member *Member `json:"member"`
}

type GetOrganizationBySlugParams struct {
	Slug string `json:"slug"`
	plugin.ExtraContainer
}

type GetOrganizationBySlugResult struct {
	Organization *Organization `json:"organization"`
}

type GetOrganizationParams struct {
	OrganizationID string `json:"organization_id"`
	plugin.ExtraContainer
}

type GetOrganizationResult struct {
	Organization *Organization `json:"organization"`
}

type GetRoleParams struct {
	RoleID string `json:"role_id"`
	plugin.ExtraContainer
}

type GetRoleResult struct {
	Role *OrganizationRole `json:"role"`
}

type GetTeamParams struct {
	TeamID string `json:"team_id"`
	plugin.ExtraContainer
}

type GetTeamResult struct {
	Team *Team `json:"team"`
}

type HasPermissionParams struct {
	OrganizationID string      `json:"organization_id"`
	UserID         string      `json:"user_id,omitempty"`
	Role           string      `json:"role,omitempty"`
	Permissions    Permissions `json:"permissions"`
	plugin.ExtraContainer
}

type HasPermissionResult struct {
	HasPermission bool `json:"has_permission"`
}

type Invitation struct {
	// ID is the unique invitation identifier.
	ID string `json:"id"`

	// OrganizationID identifies the organization to which the user is invited.
	OrganizationID string `json:"organizationId"`

	// Email is the recipient email address.
	Email string `json:"email"`

	// Role is the role to be assigned upon accepting the invitation.
	Role string `json:"role"`

	// Status indicates the current lifecycle status of the invitation.
	Status InvitationStatus `json:"status"`

	// TeamID optionally associates an initial team assignment upon accepting.
	TeamID *string `json:"teamId,omitempty"`

	// InviterID identifies the user who dispatched the invitation.
	InviterID string `json:"inviterId"`

	// ExpiresAt specifies the exact timestamp when the invitation expires.
	ExpiresAt time.Time `json:"expiresAt"`

	// CreatedAt marks when the invitation was issued.
	CreatedAt time.Time `json:"createdAt"`
}

type InvitationAcceptAfterEventPayload struct {
	Invitation   *Invitation
	Member       *Member
	Organization *Organization
	plugin.ExtraContainer
}

type InvitationAcceptBeforeEventPayload struct {
	InvitationID string
	UserID       string
	plugin.ExtraContainer
}

type InvitationCancelAfterEventPayload struct {
	Invitation *Invitation
	plugin.ExtraContainer
}

type InvitationCancelBeforeEventPayload struct {
	InvitationID string
	UserID       string
	plugin.ExtraContainer
}

type InvitationCreateAfterEventPayload struct {
	Invitation *Invitation
	plugin.ExtraContainer
}

type InvitationCreateBeforeEventPayload struct {
	OrganizationID string
	InviterID      string
	Email          string
	Role           string
	TeamID         *string
	plugin.ExtraContainer
}

type InvitationEmailData struct {
	// Invitation is the newly created invitation record.
	Invitation *Invitation

	// Organization is the organization domain record.
	Organization *Organization

	// InviterID is the user ID of the inviter.
	InviterID string

	// InviterEmail is the email of the inviter if resolved.
	InviterEmail string

	// InviterName is the display name of the inviter if resolved.
	InviterName string
}

type InvitationLimitFunc func(ctx context.Context, orgID string) (int, error)

type InvitationRejectAfterEventPayload struct {
	Invitation *Invitation
	plugin.ExtraContainer
}

type InvitationRejectBeforeEventPayload struct {
	InvitationID string
	UserID       string
	plugin.ExtraContainer
}

type InvitationRepository interface {
	// CreateInvitation persists a new email invitation to join an organization.
	CreateInvitation(ctx context.Context, invitation *Invitation) error

	// GetInvitationByID retrieves an invitation record by ID.
	GetInvitationByID(ctx context.Context, id string) (*Invitation, error)

	// GetPendingInvitation retrieves an active pending invitation by organization ID and email.
	GetPendingInvitation(ctx context.Context, orgID, email string) (*Invitation, error)

	// UpdateInvitation updates the status (e.g. accepted, revoked, expired) of an invitation.
	UpdateInvitation(ctx context.Context, invitation *Invitation) error

	// DeleteInvitation removes an invitation record from storage.
	DeleteInvitation(ctx context.Context, id string) error

	// ListInvitationsByOrgID lists invitations for an organization, optionally filtered by status.
	ListInvitationsByOrgID(ctx context.Context, orgID string, status *InvitationStatus) ([]*Invitation, error)

	// ListInvitationsByEmail lists invitations sent to a user's email across all organizations.
	ListInvitationsByEmail(ctx context.Context, email string, status *InvitationStatus) ([]*Invitation, error)

	// CountPendingInvitations returns the count of active pending invitations for an org.
	CountPendingInvitations(ctx context.Context, orgID string) (int, error)
}

type InvitationStatus string

type LeaveOrganizationParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id"`
	plugin.ExtraContainer
}

type LeaveOrganizationResult struct {
	Success bool `json:"success"`
}

type ListInvitationsParams struct {
	OrganizationID string            `json:"organization_id"`
	Status         *InvitationStatus `json:"status,omitempty"`
	plugin.ExtraContainer
}

type ListInvitationsResult struct {
	Invitations []*Invitation `json:"invitations"`
}

type ListMembersParams struct {
	OrganizationID string `json:"organization_id"`
	Limit          int    `json:"limit,omitempty"`
	Offset         int    `json:"offset,omitempty"`
	plugin.ExtraContainer
}

type ListMembersResult struct {
	Members []*Member `json:"members"`
	Total   int       `json:"total"`
}

type ListOrganizationsParams struct {
	UserID string `json:"user_id"`
	plugin.ExtraContainer
}

type ListOrganizationsResult struct {
	Organizations []*Organization `json:"organizations"`
}

type ListRolesParams struct {
	OrganizationID string `json:"organization_id"`
	plugin.ExtraContainer
}

type ListRolesResult struct {
	Roles []*OrganizationRole `json:"roles"`
}

type ListTeamMembersParams struct {
	TeamID string `json:"team_id"`
	plugin.ExtraContainer
}

type ListTeamMembersResult struct {
	Members []*TeamMember `json:"members"`
}

type ListTeamsParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type ListTeamsResult struct {
	Teams []*Team `json:"teams"`
}

type ListUserInvitationsParams struct {
	Email  string            `json:"email"`
	Status *InvitationStatus `json:"status,omitempty"`
	plugin.ExtraContainer
}

type ListUserInvitationsResult struct {
	Invitations []*Invitation `json:"invitations"`
}

type MaxMembersPerTeamFunc func(ctx context.Context, teamID string) (int, error)

type MaxRolesFunc func(ctx context.Context, orgID string) (int, error)

type MaxTeamsFunc func(ctx context.Context, orgID string) (int, error)

type Member struct {
	// ID is the unique identifier for the membership record.
	ID string `json:"id"`

	// OrganizationID identifies the parent organization.
	OrganizationID string `json:"organizationId"`

	// UserID identifies the associated user.
	UserID string `json:"userId"`

	// Role is the assigned role name (e.g. "owner", "admin", "member", or comma-separated compound roles).
	Role string `json:"role"`

	// CreatedAt marks when the user joined the organization.
	CreatedAt time.Time `json:"createdAt"`

	// UpdatedAt marks when the membership record was last updated.
	UpdatedAt *time.Time `json:"updatedAt,omitempty"`

	// User contains enriched user profile information when populated.
	User *UserInfo `json:"user,omitempty"`
}

type MemberAddAfterEventPayload struct {
	Member *Member
	plugin.ExtraContainer
}

type MemberAddBeforeEventPayload struct {
	OrganizationID string
	UserID         string
	Role           string
	plugin.ExtraContainer
}

type MemberLeaveAfterEventPayload struct {
	OrganizationID string
	UserID         string
	plugin.ExtraContainer
}

type MemberLeaveBeforeEventPayload struct {
	OrganizationID string
	UserID         string
	plugin.ExtraContainer
}

type MemberRemoveAfterEventPayload struct {
	OrganizationID string
	UserID         string
	plugin.ExtraContainer
}

type MemberRemoveBeforeEventPayload struct {
	OrganizationID string
	UserID         string
	plugin.ExtraContainer
}

type MemberRepository interface {
	// CreateMember adds a user to an organization with an assigned role.
	CreateMember(ctx context.Context, member *Member) error

	// GetMember retrieves a membership record linking a user to an organization.
	GetMember(ctx context.Context, orgID, userID string) (*Member, error)

	// GetMemberByID retrieves a membership record by its primary key ID.
	GetMemberByID(ctx context.Context, memberID string) (*Member, error)

	// UpdateMember updates the assigned role of an organization member.
	UpdateMember(ctx context.Context, member *Member) error

	// DeleteMember removes a member from an organization.
	DeleteMember(ctx context.Context, orgID, userID string) error

	// ListMembers retrieves a paginated list of organization members with enriched user profiles.
	ListMembers(ctx context.Context, orgID string, limit, offset int) ([]*Member, int, error)

	// CountMembersByRole returns the number of members holding a specific role in an organization.
	CountMembersByRole(ctx context.Context, orgID, role string) (int, error)

	// CountMembers returns the total member count in an organization.
	CountMembers(ctx context.Context, orgID string) (int, error)
}

type MemberRoleUpdateAfterEventPayload struct {
	Member *Member
	plugin.ExtraContainer
}

type MemberRoleUpdateBeforeEventPayload struct {
	OrganizationID string
	UserID         string
	NewRole        string
	plugin.ExtraContainer
}

type MembershipLimitFunc func(ctx context.Context, orgID string) (int, error)

type Option func(*Config)

type OrgCreateAfterEventPayload struct {
	Organization *Organization
	Member       *Member
	plugin.ExtraContainer
}

type OrgCreateBeforeEventPayload struct {
	UserID   string
	Name     string
	Slug     string
	Logo     string
	Metadata map[string]any
	plugin.ExtraContainer
}

type OrgDeleteAfterEventPayload struct {
	OrganizationID string
	plugin.ExtraContainer
}

type OrgDeleteBeforeEventPayload struct {
	OrganizationID string
	plugin.ExtraContainer
}

type OrgLimitFunc func(ctx context.Context, userID string) (int, error)

type OrgRepository interface {
	// CreateOrganization persists a new organization tenant boundary in storage.
	CreateOrganization(ctx context.Context, org *Organization) error

	// GetOrganizationByID retrieves an organization record by its unique ID.
	GetOrganizationByID(ctx context.Context, id string) (*Organization, error)

	// GetOrganizationBySlug retrieves an organization record by its unique URL slug.
	GetOrganizationBySlug(ctx context.Context, slug string) (*Organization, error)

	// UpdateOrganization updates mutable fields of an organization.
	UpdateOrganization(ctx context.Context, org *Organization) error

	// DeleteOrganization permanently removes an organization record and cascades related data.
	DeleteOrganization(ctx context.Context, id string) error

	// ListOrganizationsByUserID retrieves all organizations in which a user holds active membership.
	ListOrganizationsByUserID(ctx context.Context, userID string) ([]*Organization, error)
}

type OrgSetActiveAfterEventPayload struct {
	UserID         string
	OrganizationID string
	Organization   *Organization
	Member         *Member
	plugin.ExtraContainer
}

type OrgSetActiveBeforeEventPayload struct {
	UserID         string
	OrganizationID string
	plugin.ExtraContainer
}

type OrgUpdateAfterEventPayload struct {
	Organization *Organization
	plugin.ExtraContainer
}

type OrgUpdateBeforeEventPayload struct {
	OrganizationID string
	Name           *string
	Slug           *string
	Logo           *string
	Metadata       map[string]any
	plugin.ExtraContainer
}

type Organization struct {
	// ID is the unique string identifier for the organization.
	ID string `json:"id"`

	// Name is the display name of the organization.
	Name string `json:"name"`

	// Slug is the unique URL-friendly slug identifier for the organization.
	Slug string `json:"slug"`

	// Logo is an optional URL pointing to the organization's logo or avatar.
	Logo string `json:"logo,omitempty"`

	// Metadata holds arbitrary key-value properties associated with the organization.
	Metadata map[string]any `json:"metadata,omitempty"`

	// CreatedAt marks the timestamp when the organization was created.
	CreatedAt time.Time `json:"createdAt"`

	// UpdatedAt marks the timestamp when the organization was last modified.
	UpdatedAt *time.Time `json:"updatedAt,omitempty"`
}

type OrganizationRole struct {
	// ID is the unique role identifier.
	ID string `json:"id"`

	// OrganizationID identifies the parent organization owning the role.
	OrganizationID string `json:"organizationId"`

	// Role is the unique role name within the organization.
	Role string `json:"role"`

	// Permissions maps resource names to lists of granted actions (e.g. "member": ["create", "update"]).
	Permissions map[string][]string `json:"permissions"`

	// CreatedAt marks when the role was created.
	CreatedAt time.Time `json:"createdAt"`

	// UpdatedAt marks when the role was last updated.
	UpdatedAt *time.Time `json:"updatedAt,omitempty"`
}

type Permissions map[string][]string

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

type RejectInvitationParams struct {
	InvitationID string `json:"invitation_id"`
	UserID       string `json:"user_id,omitempty"`
	plugin.ExtraContainer
}

type RejectInvitationResult struct {
	Invitation *Invitation `json:"invitation"`
}

type RemoveMemberParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id"`
	InvokingUserID string `json:"invoking_user_id,omitempty"`
	plugin.ExtraContainer
}

type RemoveMemberResult struct {
	Success bool `json:"success"`
}

type RemoveTeamMemberParams struct {
	TeamID         string `json:"team_id"`
	UserID         string `json:"user_id"`
	InvokingUserID string `json:"invoking_user_id,omitempty"`
	plugin.ExtraContainer
}

type RemoveTeamMemberResult struct {
	Success bool `json:"success"`
}

type Repository interface {
	OrgRepository
	MemberRepository
	InvitationRepository
	TeamRepository
	RoleRepository
}

type RoleCreateAfterEventPayload struct {
	Role *OrganizationRole
	plugin.ExtraContainer
}

type RoleCreateBeforeEventPayload struct {
	OrganizationID string
	Role           string
	Permissions    map[string][]string
	plugin.ExtraContainer
}

type RoleDeleteAfterEventPayload struct {
	RoleID string
	plugin.ExtraContainer
}

type RoleDeleteBeforeEventPayload struct {
	RoleID string
	plugin.ExtraContainer
}

type RoleRepository interface {
	// CreateRole creates a dynamic custom role within an organization.
	CreateRole(ctx context.Context, role *OrganizationRole) error

	// GetRoleByID retrieves a custom dynamic role by ID.
	GetRoleByID(ctx context.Context, id string) (*OrganizationRole, error)

	// GetRoleByName retrieves a dynamic role by name within an organization.
	GetRoleByName(ctx context.Context, orgID, roleName string) (*OrganizationRole, error)

	// UpdateRole updates dynamic role permissions.
	UpdateRole(ctx context.Context, role *OrganizationRole) error

	// DeleteRole removes a custom dynamic role.
	DeleteRole(ctx context.Context, id string) error

	// ListRolesByOrgID lists all custom dynamic roles defined in an organization.
	ListRolesByOrgID(ctx context.Context, orgID string) ([]*OrganizationRole, error)

	// CountRoles counts custom dynamic roles defined in an organization.
	CountRoles(ctx context.Context, orgID string) (int, error)
}

type RoleUpdateAfterEventPayload struct {
	Role *OrganizationRole
	plugin.ExtraContainer
}

type RoleUpdateBeforeEventPayload struct {
	RoleID      string
	Role        *string
	Permissions map[string][]string
	plugin.ExtraContainer
}

type SendInvitationEmailFunc func(ctx context.Context, data InvitationEmailData) error

type SetActiveOrganizationParams struct {
	UserID         string `json:"user_id"`
	OrganizationID string `json:"organization_id"`
	plugin.ExtraContainer
}

type SetActiveOrganizationResult struct {
	Organization *Organization `json:"organization"`
	Member       *Member       `json:"member"`
}

type SetActiveTeamParams struct {
	UserID string `json:"user_id"`
	TeamID string `json:"team_id"`
	plugin.ExtraContainer
}

type SetActiveTeamResult struct {
	Team *Team `json:"team"`
}

type Team struct {
	// ID is the unique team identifier.
	ID string `json:"id"`

	// OrganizationID identifies the parent organization.
	OrganizationID string `json:"organizationId"`

	// Name is the display name of the team.
	Name string `json:"name"`

	// CreatedAt marks when the team was created.
	CreatedAt time.Time `json:"createdAt"`

	// UpdatedAt marks when the team was last updated.
	UpdatedAt *time.Time `json:"updatedAt,omitempty"`
}

type TeamCreateAfterEventPayload struct {
	Team *Team
	plugin.ExtraContainer
}

type TeamCreateBeforeEventPayload struct {
	OrganizationID string
	Name           string
	plugin.ExtraContainer
}

type TeamDeleteAfterEventPayload struct {
	TeamID string
	plugin.ExtraContainer
}

type TeamDeleteBeforeEventPayload struct {
	TeamID string
	plugin.ExtraContainer
}

type TeamMember struct {
	// ID is the unique identifier for the team membership record.
	ID string `json:"id"`

	// TeamID identifies the team.
	TeamID string `json:"teamId"`

	// UserID identifies the member user.
	UserID string `json:"userId"`

	// CreatedAt marks when the user joined the team.
	CreatedAt time.Time `json:"createdAt"`
}

type TeamMemberAddAfterEventPayload struct {
	TeamMember *TeamMember
	plugin.ExtraContainer
}

type TeamMemberAddBeforeEventPayload struct {
	TeamID string
	UserID string
	plugin.ExtraContainer
}

type TeamMemberRemoveAfterEventPayload struct {
	TeamID string
	UserID string
	plugin.ExtraContainer
}

type TeamMemberRemoveBeforeEventPayload struct {
	TeamID string
	UserID string
	plugin.ExtraContainer
}

type TeamRepository interface {
	// CreateTeam creates a sub-team within an organization.
	CreateTeam(ctx context.Context, team *Team) error

	// GetTeamByID retrieves a team by ID.
	GetTeamByID(ctx context.Context, id string) (*Team, error)

	// UpdateTeam updates mutable team attributes.
	UpdateTeam(ctx context.Context, team *Team) error

	// DeleteTeam removes a team and unassigns members.
	DeleteTeam(ctx context.Context, id string) error

	// ListTeamsByOrgID lists all teams belonging to an organization.
	ListTeamsByOrgID(ctx context.Context, orgID string) ([]*Team, error)

	// ListTeamsByUserID lists teams in an organization to which a user belongs.
	ListTeamsByUserID(ctx context.Context, orgID, userID string) ([]*Team, error)

	// CountTeams returns the count of teams in an organization.
	CountTeams(ctx context.Context, orgID string) (int, error)

	// AddTeamMember assigns a user to a team.
	AddTeamMember(ctx context.Context, teamMember *TeamMember) error

	// RemoveTeamMember unassigns a user from a team.
	RemoveTeamMember(ctx context.Context, teamID, userID string) error

	// GetTeamMember retrieves a team member mapping record.
	GetTeamMember(ctx context.Context, teamID, userID string) (*TeamMember, error)

	// ListTeamMembers lists all member assignments for a team.
	ListTeamMembers(ctx context.Context, teamID string) ([]*TeamMember, error)

	// CountTeamMembers counts members assigned to a team.
	CountTeamMembers(ctx context.Context, teamID string) (int, error)
}

type TeamSetActiveAfterEventPayload struct {
	UserID string
	TeamID string
	Team   *Team
	plugin.ExtraContainer
}

type TeamSetActiveBeforeEventPayload struct {
	UserID string
	TeamID string
	plugin.ExtraContainer
}

type TeamUpdateAfterEventPayload struct {
	Team *Team
	plugin.ExtraContainer
}

type TeamUpdateBeforeEventPayload struct {
	TeamID string
	Name   string
	plugin.ExtraContainer
}

type UpdateMemberRoleParams struct {
	OrganizationID string `json:"organization_id"`
	UserID         string `json:"user_id"`
	Role           string `json:"role"`
	InvokingUserID string `json:"invoking_user_id,omitempty"`
	plugin.ExtraContainer
}

type UpdateMemberRoleResult struct {
	Member *Member `json:"member"`
}

type UpdateOrganizationParams struct {
	OrganizationID string         `json:"organization_id"`
	UserID         string         `json:"user_id,omitempty"`
	Name           *string        `json:"name,omitempty"`
	Slug           *string        `json:"slug,omitempty"`
	Logo           *string        `json:"logo,omitempty"`
	Metadata       map[string]any `json:"metadata,omitempty"`
	plugin.ExtraContainer
}

type UpdateOrganizationResult struct {
	Organization *Organization `json:"organization"`
}

type UpdateRoleParams struct {
	RoleID      string              `json:"role_id"`
	UserID      string              `json:"user_id,omitempty"`
	Role        *string             `json:"role,omitempty"`
	Permissions map[string][]string `json:"permissions,omitempty"`
	plugin.ExtraContainer
}

type UpdateRoleResult struct {
	Role *OrganizationRole `json:"role"`
}

type UpdateTeamParams struct {
	TeamID string `json:"team_id"`
	UserID string `json:"user_id,omitempty"`
	Name   string `json:"name"`
	plugin.ExtraContainer
}

type UpdateTeamResult struct {
	Team *Team `json:"team"`
}

type UserInfo struct {
	// ID is the unique user identifier.
	ID string `json:"id"`

	// Email is the user's primary email address.
	Email string `json:"email"`

	// Name is the user's display name.
	Name string `json:"name"`

	// Image is an optional avatar or profile image URL.
	Image string `json:"image,omitempty"`
}