invite

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

type APIConfig struct {
	// BasePath is the base path for all endpoints (default: "/api/v1").
	BasePath string
	// Logger is the logger to use (default: slog.Default()).
	Logger *slog.Logger
}

type AcceptInviteInput struct {
	Token       string
	PrincipalID uuid.UUID // The principal accepting the invite
}

type AcceptInviteRequest struct {
	Token string `path:"token"`
	Body  struct {
		PrincipalID string `json:"principal_id" required:"true" format:"uuid"`
	}
}

type AcceptInviteResponse struct {
	Body *InviteResponse
}

type CreateInviteInput struct {
	OrganizationID     uuid.UUID
	InviterPrincipalID uuid.UUID
	Email              string
	Role               string
	Message            *string
	ExpiresIn          time.Duration // How long until expiry (default: 7 days)
}

type CreateInviteRequest struct {
	Slug string `path:"slug"`
	Body struct {
		Email              string  `json:"email" required:"true" format:"email"`
		Role               string  `json:"role" required:"true" enum:"owner,admin,member"`
		Message            *string `json:"message,omitempty"`
		InviterPrincipalID string  `json:"inviter_principal_id" required:"true" format:"uuid"`
		ExpiresInHours     int     `json:"expires_in_hours,omitempty" minimum:"1" maximum:"720"`
	}
}

type CreateInviteResponse struct {
	Body *InviteResultResponse
}

type DeclineInviteRequest struct {
	Token string `path:"token"`
}

type DeclineInviteResponse struct {
	Body *InviteResponse
}

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

type GetInviteByTokenRequest struct {
	Token string `path:"token"`
}

type GetInviteByTokenResponse struct {
	Body *InviteResponse
}

type Invite struct {
	ID                    uuid.UUID
	OrganizationID        uuid.UUID
	InviterPrincipalID    uuid.UUID
	Email                 string
	Role                  string
	Token                 string
	Status                Status
	Message               *string
	ExpiresAt             time.Time
	AcceptedAt            *time.Time
	AcceptedByPrincipalID *uuid.UUID
	ResendCount           int
	LastSentAt            time.Time
	CreatedAt             time.Time
	UpdatedAt             time.Time
}

type InviteResponse struct {
	ID                    string     `json:"id"`
	OrganizationID        string     `json:"organization_id"`
	InviterPrincipalID    string     `json:"inviter_principal_id"`
	Email                 string     `json:"email"`
	Role                  string     `json:"role"`
	Status                string     `json:"status"`
	Message               *string    `json:"message,omitempty"`
	ExpiresAt             time.Time  `json:"expires_at"`
	AcceptedAt            *time.Time `json:"accepted_at,omitempty"`
	AcceptedByPrincipalID *string    `json:"accepted_by_principal_id,omitempty"`
	ResendCount           int        `json:"resend_count"`
	LastSentAt            time.Time  `json:"last_sent_at"`
	CreatedAt             time.Time  `json:"created_at"`
	UpdatedAt             time.Time  `json:"updated_at"`
}

type InviteResult struct {
	Invite *Invite
	// InviteURL is the full URL to accept the invite
	InviteURL string
}

type InviteResultResponse struct {
	Invite    *InviteResponse `json:"invite"`
	InviteURL string          `json:"invite_url"`
}

type ListInvitesInput struct {
	OrganizationID *uuid.UUID
	Email          *string
	Status         *Status
	Limit          int
	Offset         int
}

type ListInvitesRequest struct {
	Slug   string  `path:"slug"`
	Status *string `query:"status" enum:"pending,accepted,declined,expired,revoked"`
	Limit  int     `query:"limit" default:"20" minimum:"1" maximum:"100"`
	Offset int     `query:"offset" default:"0" minimum:"0"`
}

type ListInvitesResponse struct {
	Body struct {
		Invites []*InviteResponse `json:"invites"`
	}
}

type ListPendingInvitesForEmailRequest struct {
	Email string `query:"email" required:"true" format:"email"`
}

type ListPendingInvitesForEmailResponse struct {
	Body struct {
		Invites []*InviteResponse `json:"invites"`
	}
}

type ResendInviteRequest struct {
	Slug     string `path:"slug"`
	InviteID string `path:"invite_id" format:"uuid"`
}

type ResendInviteResponse struct {
	Body *InviteResultResponse
}

type RevokeInviteRequest struct {
	Slug     string `path:"slug"`
	InviteID string `path:"invite_id" format:"uuid"`
}

type Service interface {
	// Create creates a new invite.
	Create(ctx context.Context, input CreateInviteInput) (*InviteResult, error)

	// GetByToken retrieves an invite by its token.
	GetByToken(ctx context.Context, token string) (*Invite, error)

	// GetByID retrieves an invite by ID.
	GetByID(ctx context.Context, id uuid.UUID) (*Invite, error)

	// Accept accepts an invite and creates the membership.
	Accept(ctx context.Context, input AcceptInviteInput) (*Invite, error)

	// Decline declines an invite.
	Decline(ctx context.Context, token string) (*Invite, error)

	// Revoke revokes an invite.
	Revoke(ctx context.Context, id uuid.UUID) error

	// Resend resends an invite with a new token.
	Resend(ctx context.Context, id uuid.UUID) (*InviteResult, error)

	// List lists invites with optional filters.
	List(ctx context.Context, input ListInvitesInput) ([]*Invite, error)

	// ListPendingForEmail lists pending invites for an email address.
	ListPendingForEmail(ctx context.Context, email string) ([]*Invite, error)

	// ExpireOld expires invites that have passed their expiration time.
	ExpireOld(ctx context.Context) (int, error)

	// HasPendingInvite checks if there's already a pending invite for this email/org.
	HasPendingInvite(ctx context.Context, organizationID uuid.UUID, email string) (bool, error)
}

type Status string