username

type AuthenticateInput struct {
	Username string
	Password string
	Session  auth.SessionOptions
}

type Capability interface {
	// Authenticate validates the username and password, issuing an opaque session.
	// Applies timing equalization to prevent username enumeration if user does not exist.
	Authenticate(ctx context.Context, in AuthenticateInput) (*auth.AuthResult, error)

	// Register atomically creates a new Core User, Account, Credential, and Username mapping.
	Register(ctx context.Context, in RegisterInput) (*auth.AuthResult, error)

	// Set assigns a username to an existing Core user.
	Set(ctx context.Context, userID, rawUsername string) error

	// Change modifies an existing username for a user, invalidating caches.
	Change(ctx context.Context, userID, newRawUsername string) error

	// Delete removes the username assignment for a user.
	Delete(ctx context.Context, userID string) error

	// GetByUserID retrieves the username record for a given Core user ID.
	GetByUserID(ctx context.Context, userID string) (*Record, error)

	// GetByUsername retrieves the username record for a raw username.
	GetByUsername(ctx context.Context, rawUsername string) (*Record, error)

	// Lookup returns the Core user ID associated with the username.
	Lookup(ctx context.Context, rawUsername string) (string, error)

	// Validate checks if a raw username satisfies validation rules.
	Validate(rawUsername string) error

	// Normalize computes the canonical representation of a raw username.
	Normalize(rawUsername string) (string, error)
}

type Config struct {
	MinLength     int
	MaxLength     int
	CaseSensitive bool
	Reserved      map[string]struct{}
	Normalizer    Normalizer
	Validator     Validator
	CacheTTL      time.Duration
}

type CreatedPayload struct {
	UserID     string `json:"user_id"`
	Username   string `json:"username"`
	Normalized string `json:"normalized"`
}

type DeletedPayload struct {
	UserID     string `json:"user_id"`
	Username   string `json:"username"`
	Normalized string `json:"normalized"`
}

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

type Normalizer func(username string) (string, error)

type Option func(*Config)

type Record struct {
	UserID     string    `json:"user_id"`
	Username   string    `json:"username"`   // Display username in original casing
	Normalized string    `json:"normalized"` // Canonical search key for uniqueness & lookups
	CreatedAt  time.Time `json:"created_at"`
	UpdatedAt  time.Time `json:"updated_at"`
}

type RegisterInput struct {
	Email    string
	Username string
	Password string
	Session  auth.SessionOptions
}

type UpdatedPayload struct {
	UserID        string `json:"user_id"`
	OldUsername   string `json:"old_username"`
	NewUsername   string `json:"new_username"`
	OldNormalized string `json:"old_normalized"`
	NewNormalized string `json:"new_normalized"`
}

type Username = Capability

type Validator func(username string) error