signup

type AcceptInviteOnSignupInput struct {
	// SignupInput contains the user's signup details.
	SignupInput
	// InviteToken is the invitation token to accept.
	InviteToken string
}

type AcceptInviteOnSignupResult struct {
	// SignupResult contains the user and personal org.
	SignupResult
	// InvitedOrganizationID is the organization from the invite.
	InvitedOrganizationID uuid.UUID
	// InvitedRole is the role granted by the invite.
	InvitedRole string
}

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

type PersonalOrg struct {
	Organization *ent.Organization
	Membership   *ent.PrincipalMembership
}

type PersonalOrgParams struct {
	// OwnerID is the owning principal; it becomes the active owner member.
	OwnerID uuid.UUID
	// Name is the organization's display name (required).
	Name string
	// Slug is the preferred slug. It is made valid and, when taken, given a
	// numeric suffix. Use SlugForLogin to derive it.
	Slug string
	// ReservedSlugs are deployment-configured slugs to avoid in addition to
	// organization.ReservedSlugs; a reserved slug gets a numeric suffix.
	ReservedSlugs []string
	// LogoURL is the optional logo, usually the owner's avatar.
	LogoURL string
}

type Service interface {
	// Signup creates a new user with their personal organization.
	// This is the standard signup flow for new users.
	Signup(ctx context.Context, input SignupInput) (*SignupResult, error)

	// SignupWithInvite creates a new user, their personal org, and accepts an invite.
	// This is used when a user signs up by accepting an invitation to an org.
	SignupWithInvite(ctx context.Context, input AcceptInviteOnSignupInput) (*AcceptInviteOnSignupResult, error)

	// SignupOrGetExisting handles the OAuth login flow:
	// - If user exists, returns them and their personal org
	// - If user doesn't exist, creates them with personal org
	SignupOrGetExisting(ctx context.Context, input SignupInput) (*SignupResult, bool, error)
}

type SignupInput struct {
	// Email is the user's email address (required).
	Email string
	// DisplayName is the user's display name (required).
	DisplayName string
	// GivenName is the user's first name (optional).
	GivenName string
	// FamilyName is the user's last name (optional).
	FamilyName string
	// AvatarURL is the user's avatar URL (optional, often from OAuth provider).
	AvatarURL *string
	// Locale is the user's preferred locale (optional).
	Locale string
	// Timezone is the user's preferred timezone (optional).
	Timezone string
	// PersonalOrgSlug is the URL-safe slug for the personal org (required).
	// Usually derived from email or username.
	PersonalOrgSlug string
	// PersonalOrgName is the display name for the personal org (optional).
	// Defaults to the user's DisplayName if not provided.
	PersonalOrgName string
	// Metadata contains optional metadata for the user.
	Metadata map[string]any
	// EmailVerified asserts that the caller verified Email belongs to the
	// person signing up, for example an identity provider's verified
	// flag. SignupOrGetExisting returns an existing account for an email
	// only when it is set.
	EmailVerified bool
}

type SignupResult struct {
	// Principal is the created human principal.
	Principal *principal.Principal
	// PersonalOrganization is the created personal organization.
	PersonalOrganization *organization.Organization
	// Membership is the owner membership in the personal organization.
	Membership *organization.Membership
}