shared

type Breadcrumb struct {
	Name string
	URL  string
}

type FlashRedirectFunc func(w http.ResponseWriter, r *http.Request, messageType, message, redirectURL string, seconds int) string

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

type UiBase struct {
	UserStoreField                  userstore.StoreInterface
	GeoStoreField                   geostore.StoreInterface
	LoggerField                     *slog.Logger
	SessionStoreField               sessionstore.StoreInterface
	BlindIndexFirstNameField        blindindexstore.StoreInterface
	BlindIndexLastNameField         blindindexstore.StoreInterface
	BlindIndexEmailField            blindindexstore.StoreInterface
	TaskStoreField                  taskstore.StoreInterface
	BlindIndexRebuildTaskAliasField string
	VaultTokenizerField             VaultTokenizer
	AuthUserField                   func(r *http.Request) userstore.UserInterface
	FlashRedirectField              FlashRedirectFunc
	SecureCookieField               bool
	LayoutField                     func(w http.ResponseWriter, r *http.Request, webpageTitle, webpageHtml string, options struct {
		Styles     []string
		StyleURLs  []string
		Scripts    []string
		ScriptURLs []string
	}) string
}

type UiConfig struct {
	UserStore userstore.StoreInterface
	GeoStore  geostore.StoreInterface
	Logger    *slog.Logger

	// SessionStore is required for the impersonate controller.
	SessionStore sessionstore.StoreInterface

	// BlindIndexFirstName/LastName/Email enable filtered search by
	// the corresponding field. Optional.
	BlindIndexFirstName blindindexstore.StoreInterface
	BlindIndexLastName  blindindexstore.StoreInterface
	BlindIndexEmail     blindindexstore.StoreInterface

	// TaskStore is used to enqueue a blind index rebuild when a user's
	// email changes and vault tokenization is enabled. Optional.
	TaskStore taskstore.StoreInterface

	// BlindIndexRebuildTaskAlias is the task alias enqueued on email
	// change. If empty, the enqueue is skipped.
	BlindIndexRebuildTaskAlias string

	// VaultTokenizer abstracts vault tokenization. Optional — when
	// nil, user fields are treated as plain text.
	VaultTokenizer VaultTokenizer

	// AuthUser returns the authenticated user from the request, or
	// nil if unauthenticated. Used by the create/delete/impersonate
	// controllers for authorization checks.
	AuthUser func(r *http.Request) userstore.UserInterface

	// FlashRedirect redirects with a flash message. Optional — when
	// nil, plain http.Redirect is used.
	FlashRedirect FlashRedirectFunc

	// SecureCookie controls whether the impersonation cookie is marked
	// Secure. Set to false for HTTP (development), true for HTTPS
	// (production). Defaults to true.
	SecureCookie bool

	// Layout is the layout renderer callback.
	Layout func(w http.ResponseWriter, r *http.Request, webpageTitle, webpageHtml string, options struct {
		Styles     []string
		StyleURLs  []string
		Scripts    []string
		ScriptURLs []string
	}) string
}

type UiInterface interface {
	UserStore() userstore.StoreInterface
	GeoStore() geostore.StoreInterface
	Logger() *slog.Logger
	SessionStore() sessionstore.StoreInterface
	BlindIndexFirstName() blindindexstore.StoreInterface
	BlindIndexLastName() blindindexstore.StoreInterface
	BlindIndexEmail() blindindexstore.StoreInterface
	TaskStore() taskstore.StoreInterface
	BlindIndexRebuildTaskAlias() string
	VaultTokenizer() VaultTokenizer
	AuthUser(r *http.Request) userstore.UserInterface
	FlashRedirect() FlashRedirectFunc
	SecureCookie() bool

	Layout(w http.ResponseWriter, r *http.Request, webpageTitle, webpageHtml string, options struct {
		Styles     []string
		StyleURLs  []string
		Scripts    []string
		ScriptURLs []string
	}) string
}

type VaultTokenizer interface {
	// Tokenize upserts tokens for the given user fields and returns
	// the resulting token strings to store on the user record.
	Tokenize(
		ctx context.Context,
		user userstore.UserInterface,
		firstName, lastName, email, phone, businessName string,
	) (firstNameToken, lastNameToken, emailToken, phoneToken, businessNameToken string, err error)

	// Untokenize resolves the tokenized fields on the given user back
	// to their plain-text values.
	Untokenize(
		ctx context.Context,
		user userstore.UserInterface,
	) (firstName, lastName, email, phone, businessName string, err error)
}