anonymous

type Config struct {
	// EmailDomainName specifies the domain used for generated anonymous email addresses (e.g. temp-{uuid}@anonymous.local).
	// Default: "anonymous.local"
	EmailDomainName string

	// DisableDeleteAnonymousUser specifies whether automatic deletion of anonymous accounts after linking should be disabled.
	// Default: false
	DisableDeleteAnonymousUser bool

	// OnLinkAccount is a callback function invoked when a guest user links their account to a permanent user.
	OnLinkAccount LinkAccountCallback

	// GenerateName is a custom callback to generate anonymous user names. If nil, defaults to "Anonymous".
	GenerateName GenerateNameCallback

	// GenerateRandomEmail is a custom callback to generate anonymous email addresses. If nil, defaults to "temp-{uuid}@" + EmailDomainName.
	GenerateRandomEmail GenerateEmailCallback

	// CookieName specifies the session cookie key name.
	CookieName string

	// CookiePath specifies the HTTP cookie path scope. Default: "/"
	CookiePath string

	// CookieDomain specifies the HTTP cookie domain scope.
	CookieDomain string

	// CookieMaxAge specifies the session cookie duration. Default: 30 days.
	CookieMaxAge time.Duration

	// CookieSecure specifies whether the session cookie requires HTTPS. Default: false.
	CookieSecure bool

	// CookieSameSite specifies the SameSite attribute for session cookies. Default: http.SameSiteLaxMode.
	CookieSameSite http.SameSite
}

type DeleteAnonymousEventPayload struct {
	UserID string `json:"user_id"`
}

type DeleteAnonymousUserResult struct {
	Success bool `json:"success"`
}

type GenerateEmailCallback func(ctx context.Context) (string, error)

type GenerateNameCallback func(ctx context.Context) (string, error)

type LinkAccountCallback func(ctx context.Context, data *OnLinkAccountData) error

type LinkAccountEventPayload struct {
	Data *OnLinkAccountData `json:"data"`
}

type MemoryRepository struct {
	*repository.MemorySessionRepository
	// contains filtered or unexported fields
}

type OnLinkAccountData struct {
	AnonymousUser UserSessionPair `json:"anonymous_user"`
	NewUser       UserSessionPair `json:"new_user"`
}

type Option func(*Config)

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

type Repository interface {
	repository.SessionRepository

	// CreateAnonymousUser persists a new guest user entity with IsAnonymous set to true.
	CreateAnonymousUser(ctx context.Context, email, name string) (*entity.User, error)

	// GetUserByID fetches a user entity by primary key ID.
	GetUserByID(ctx context.Context, userID string) (*entity.User, error)

	// DeleteUser removes a user record from persistent storage by ID.
	DeleteUser(ctx context.Context, userID string) error
}

type SignInAnonymousEventPayload struct {
	User    *entity.User    `json:"user"`
	Session *entity.Session `json:"session"`
}

type SignInAnonymousParams struct {
	IPAddress string `json:"ip_address,omitempty"`
	UserAgent string `json:"user_agent,omitempty"`
}

type SignInAnonymousResult struct {
	User    *entity.User    `json:"user"`
	Session *entity.Session `json:"session"`
	Token   string          `json:"token"`
}

type UserSessionPair struct {
	User    *entity.User    `json:"user"`
	Session *entity.Session `json:"session"`
}