account

type ACLAccount struct {
	models.AccountBase
}

type Filter struct {
	ID     []uint64
	UserID []uint64
	Title  []string
	Status []pkgModels.ApproveStatus
}

type ListOptions = repository.ListOptions

type ListOrder struct {
	ID        pkgModels.Order
	Title     pkgModels.Order
	Status    pkgModels.Order
	CreatedAt pkgModels.Order
	UpdatedAt pkgModels.Order
}

type M2MAccountMemberRole = models.M2MAccountMemberRole

type Member[TUser user.Model, TAccount Model] struct {
	models.MemberBase
	Account TAccount `db:"-" gorm:"foreignKey:AccountID;references:ID"`
	User    TUser    `db:"-" gorm:"foreignKey:UserID;references:ID"`
}

type MemberFilter struct {
	ID        []uint64
	AccountID []uint64
	UserID    []uint64
	NotUserID []uint64
	Status    []pkgModels.ApproveStatus
	IsAdmin   null.Bool
}

type MemberListOrder struct {
	ID        pkgModels.Order
	AccountID pkgModels.Order
	UserID    pkgModels.Order
	Status    pkgModels.Order
	IsAdmin   pkgModels.Order
	CreatedAt pkgModels.Order
	UpdatedAt pkgModels.Order
}

type MemberModel interface {
	GetID() uint64
	OwnerAccountID() uint64
}

type MemberRepository[TUser user.Model, TAccount Model] interface {
	// EmptyObject returns a new empty member object of type Member[TUser, TAccount].
	EmptyObject() *Member[TUser, TAccount]

	// IsAdmin checks if the user is an admin of the account.
	IsAdmin(ctx context.Context, userID, accountID uint64) bool

	// IsMember checks if the user is a member of the account.
	IsMember(ctx context.Context, userID, accountID uint64) bool

	// FetchListMembers retrieves a list of members for the account.
	FetchListMembers(ctx context.Context, opts ...QOption) ([]*Member[TUser, TAccount], error)

	// CountMembers counts the number of members for the account.
	CountMembers(ctx context.Context, opts ...QOption) (int64, error)

	// Member retrieves a member by user ID and account ID.
	Member(ctx context.Context, userID, accountID uint64) (*Member[TUser, TAccount], error)

	// MemberByID retrieves a member by member ID.
	MemberByID(ctx context.Context, id uint64) (*Member[TUser, TAccount], error)

	// LinkMember links users as members to the account with optional admin role.
	LinkMember(ctx context.Context, account TAccount, isAdmin bool, members ...TUser) error

	// UnlinkMember unlinks users from the account.
	UnlinkMember(ctx context.Context, account TAccount, members ...TUser) error

	// UnlinkAccountMember unlinks a member from the account by member ID.
	SetMemberRoles(ctx context.Context, account TAccount, member TUser, roles ...string) error
}

type MemberUsecase[TUser user.Model, TAccount Model] interface {
	// EmptyObject returns a new empty member object of type Member[TUser, TAccount].
	EmptyObject() *Member[TUser, TAccount]

	// FetchListMembers retrieves a list of members based on the provided query options.
	FetchListMembers(ctx context.Context, opts ...QOption) ([]*Member[TUser, TAccount], error)

	// CountMembers returns the total number of members based on the provided query options.
	CountMembers(ctx context.Context, opts ...QOption) (int64, error)

	// LinkMember associates a user with an account, optionally granting admin privileges.
	LinkMember(ctx context.Context, account TAccount, isAdmin bool, members ...TUser) error

	// UnlinkMember removes the association between a user and an account.
	UnlinkMember(ctx context.Context, account TAccount, members ...TUser) error

	// UnlinkAccountMember removes a member from an account based on the member's ID.
	UnlinkAccountMember(ctx context.Context, memberID uint64) error

	// InviteMember sends an invitation to a user to join an account with specified roles.
	InviteMember(ctx context.Context, accountID, userID uint64, roles ...string) (*Member[TUser, TAccount], error)

	// SetAccountMemeberRoles sets the roles for a user within a specific account.
	SetAccountMemeberRoles(ctx context.Context, accountID, userID uint64, roles ...string) (*Member[TUser, TAccount], error)

	// SetMemberRoles sets the roles for a member based on the member's ID.
	SetMemberRoles(ctx context.Context, memberID uint64, roles ...string) (*Member[TUser, TAccount], error)
}

type Model interface {
	auth.IsNillable
	GetID() uint64

	IsAnonymous() bool
	OwnerAccountID() uint64

	GetApprove() pkgModels.ApproveStatus
	GetCreatedAt() time.Time
	GetUpdatedAt() time.Time

	NewWithIDs(id uint64, adminUserIDs ...uint64) Model

	CheckPermissions(ctx context.Context, resource any, patterns ...string) bool
	CheckedPermissions(ctx context.Context, resource any, patterns ...string) rbac.Permission
	IsAdminUser(userID uint64) bool
	IsOwnerUser(userID uint64) bool
	ExtendAdminUsers(ids ...uint64)
	SetPermissions(perm PermissionChecker)
	ExtendPermissions(perm PermissionChecker)
	PermissionsChecker() PermissionChecker
	ListPermissions(patterns ...string) []rbac.Permission
	HasPermission(patterns ...string) bool
}

type Pagination = repository.Pagination

type PermissionChecker = models.PermissionChecker

type QOption = repository.QOption

type Repository[T Model] interface {
	// EmptyObject returns a new empty account object of type T.
	EmptyObject() T

	// Get retrieves an account by ID.
	// Returns ErrNotFound if the account does not exist.
	Get(ctx context.Context, id uint64) (T, error)

	// FetchList retrieves a list of accounts based on the provided query options.
	// Returns an empty slice if no accounts match the criteria.
	FetchList(ctx context.Context, opts ...QOption) ([]T, error)

	// Count returns the number of accounts matching the provided query options.
	Count(ctx context.Context, opts ...QOption) (int64, error)

	// Create creates a new account and returns its ID.
	// Returns an error if the account could not be created.
	Create(ctx context.Context, account T) (uint64, error)

	// Update updates an existing account.
	// Returns an error if the account could not be updated.
	Update(ctx context.Context, id uint64, account T) error

	// Delete deletes an account by ID.
	// Returns an error if the account could not be deleted.
	Delete(ctx context.Context, id uint64) error
}

type SessionRepository[TUser user.Model, TAccount Model] interface {
	Repository[TAccount]

	// LoadPermissions loads the permissions for the given user and account.
	LoadPermissions(ctx context.Context, account TAccount, userObj TUser) error

	// GetByToken retrieves the user and account associated with the given session token.
	// Returns ErrInvalidToken if the token is invalid or expired.
	GetByToken(ctx context.Context, token string) (TUser, TAccount, error)
}

type Usecase[TUser user.Model, TAccount Model] interface {
	// EmptyObject returns a new empty account object of type TAccount.
	EmptyObject() TAccount

	// Get retrieves an account by ID.
	Get(ctx context.Context, id uint64) (TAccount, error)

	// FetchList retrieves a list of accounts based on the provided query options.
	FetchList(ctx context.Context, opts ...QOption) ([]TAccount, error)

	// Count returns the total number of accounts based on the provided query options.
	Count(ctx context.Context, opts ...QOption) (int64, error)

	// Update modifies an existing account.
	Update(ctx context.Context, account TAccount) (uint64, error)

	// Register creates a new account with the specified owner and account details.
	Register(ctx context.Context, ownerObj TUser, accountObj TAccount) (uint64, error)

	// Delete removes an account by ID.
	Delete(ctx context.Context, id uint64) error
}