waitlist

type ApproveRequest struct {
	EntryID string `path:"entryId" description:"Waitlist entry ID"`
	Note    string `json:"note,omitempty" description:"Optional admin note"`
}

type Config struct {
	// Enabled controls whether the waitlist gate is active.
	// When true, sign-ups require a prior approved waitlist entry.
	Enabled bool
}

type DeleteRequest struct {
	EntryID string `path:"entryId" description:"Waitlist entry ID"`
}

type JoinRequest struct {
	Email string `json:"email" description:"Email address to add to the waitlist"`
	Name  string `json:"name,omitempty" description:"Display name (optional)"`
	AppID string `json:"app_id,omitempty" description:"Application ID (optional, resolved from context if absent)"`
}

type ListRequest struct {
	AppID  string `query:"app_id" description:"Filter by application ID"`
	Email  string `query:"email" description:"Filter by email address"`
	Status string `query:"status" description:"Filter by status (pending, approved, rejected)"`
	Cursor string `query:"cursor" description:"Pagination cursor"`
	Limit  int    `query:"limit" description:"Maximum number of results (default 50, max 200)"`
}

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

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

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

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

type RejectRequest struct {
	EntryID string `path:"entryId" description:"Waitlist entry ID"`
	Note    string `json:"note,omitempty" description:"Optional admin note"`
}

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

type StatsRequest struct {
	AppID string `query:"app_id" description:"Application ID"`
}

type StatsResponse struct {
	Pending  int `json:"pending" description:"Number of pending entries"`
	Approved int `json:"approved" description:"Number of approved entries"`
	Rejected int `json:"rejected" description:"Number of rejected entries"`
	Total    int `json:"total" description:"Total number of entries"`
}

type StatusRequest struct {
	Email string `query:"email" description:"Email address to check"`
	AppID string `query:"app_id" description:"Application ID (optional)"`
}

type StatusResponse struct {
	Email  string         `json:"email" description:"Email address"`
	Status WaitlistStatus `json:"status" description:"Waitlist status (pending, approved, rejected)"`
}

type Store interface {
	// CreateEntry adds a new waitlist entry.
	CreateEntry(ctx context.Context, e *WaitlistEntry) error

	// GetEntry returns a waitlist entry by ID.
	GetEntry(ctx context.Context, entryID id.WaitlistID) (*WaitlistEntry, error)

	// GetEntryByEmail returns a waitlist entry by app and email.
	GetEntryByEmail(ctx context.Context, appID id.AppID, email string) (*WaitlistEntry, error)

	// UpdateEntryStatus changes the status and optionally sets a note.
	UpdateEntryStatus(ctx context.Context, entryID id.WaitlistID, status WaitlistStatus, note string) error

	// ListEntries returns waitlist entries matching the query.
	ListEntries(ctx context.Context, q *WaitlistQuery) (*WaitlistList, error)

	// CountByStatus returns counts of entries grouped by status for an app.
	CountByStatus(ctx context.Context, appID id.AppID) (pending, approved, rejected int, err error)

	// DeleteEntry permanently removes a waitlist entry.
	DeleteEntry(ctx context.Context, entryID id.WaitlistID) error
}

type WaitlistEntry struct {
	ID        id.WaitlistID  `json:"id"`
	AppID     id.AppID       `json:"app_id"`
	Email     string         `json:"email"`
	Name      string         `json:"name"`
	Status    WaitlistStatus `json:"status"`
	UserID    *id.UserID     `json:"user_id,omitempty"` // set after sign-up
	IPAddress string         `json:"ip_address"`
	Note      string         `json:"note"`
	CreatedAt time.Time      `json:"created_at"`
	UpdatedAt time.Time      `json:"updated_at"`
}

type WaitlistList struct {
	Entries    []*WaitlistEntry `json:"entries"`
	Total      int              `json:"total"`
	NextCursor string           `json:"next_cursor,omitempty"`
}

type WaitlistQuery struct {
	AppID  id.AppID       `json:"app_id"`
	Email  string         `json:"email,omitempty"`
	Status WaitlistStatus `json:"status,omitempty"`
	Cursor string         `json:"cursor,omitempty"`
	Limit  int            `json:"limit,omitempty"`
}

type WaitlistStatus string //nolint:revive // exported name stutter is intentional for clarity