hook

type APIKeyEvent ¶ added in v0.3.0

type APIKeyEvent struct {
	Key  *store.APIKey
	User *store.User
	Tx   store.Store
}

APIKeyEvent carries a created or a revoked API key. The plaintext key is never part of it.

type AccountLink ¶

type AccountLink struct {
	User    *store.User
	Account *store.Account
}

AccountLink carries a completed external account link.

type AfterAPIKeyCreateFunc ¶ added in v0.3.0

type AfterAPIKeyCreateFunc func(ctx context.Context, ev *APIKeyEvent) error

AfterAPIKeyCreateFunc runs after commit.

type AfterAPIKeyRevokeFunc ¶ added in v0.3.0

type AfterAPIKeyRevokeFunc func(ctx context.Context, ev *APIKeyEvent) error

AfterAPIKeyRevokeFunc runs after commit.

type AfterAccountLinkFunc ¶

type AfterAccountLinkFunc func(ctx context.Context, ev *AccountLink) error

AfterAccountLinkFunc runs after commit.

type AfterPasswordChangeFunc ¶

type AfterPasswordChangeFunc func(ctx context.Context, ev *PasswordChange) error

AfterPasswordChangeFunc runs after commit.

type AfterRoleChangeFunc ¶ added in v0.3.0

type AfterRoleChangeFunc func(ctx context.Context, ev *RoleChange) error

AfterRoleChangeFunc runs after commit.

type AfterSessionCreateFunc ¶

type AfterSessionCreateFunc func(ctx context.Context, ev *SessionCreate) error

AfterSessionCreateFunc runs after commit.

type AfterSignInFunc ¶

type AfterSignInFunc func(ctx context.Context, ev *SignIn) error

AfterSignInFunc runs after commit.

type AfterSignOutFunc ¶

type AfterSignOutFunc func(ctx context.Context, ev *SignOut) error

AfterSignOutFunc runs after commit.

type AfterUserCreateFunc ¶

type AfterUserCreateFunc func(ctx context.Context, ev *UserCreate) error

AfterUserCreateFunc runs after commit.

type AfterUserUpdateFunc ¶ added in v0.3.0

type AfterUserUpdateFunc func(ctx context.Context, ev *UserUpdate) error

AfterUserUpdateFunc runs after commit.

type BeforeRoleChangeFunc ¶ added in v0.3.0

type BeforeRoleChangeFunc func(ctx context.Context, ev *RoleChange) error

BeforeRoleChangeFunc runs in the transaction and can reject.

type BeforeSessionCreateFunc ¶

type BeforeSessionCreateFunc func(ctx context.Context, ev *SessionCreate) error

BeforeSessionCreateFunc runs in the transaction and can reject.

type BeforeUserCreateFunc ¶

type BeforeUserCreateFunc func(ctx context.Context, ev *UserCreate) error

BeforeUserCreateFunc runs in the transaction and can reject.

type BeforeUserUpdateFunc ¶ added in v0.3.0

type BeforeUserUpdateFunc func(ctx context.Context, ev *UserUpdate) error

BeforeUserUpdateFunc runs in the transaction and can reject.

type Hooks ¶

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

Hooks holds every registered lifecycle hook.

func New(onError func(ctx context.Context, name string, err error)) *Hooks

func (h *Hooks) OnAfterAPIKeyCreate(fn AfterAPIKeyCreateFunc)

func (h *Hooks) OnAfterAPIKeyRevoke(fn AfterAPIKeyRevokeFunc)

func (h *Hooks) OnAfterAccountLink(fn AfterAccountLinkFunc)

func (h *Hooks) OnAfterPasswordChange(fn AfterPasswordChangeFunc)

func (h *Hooks) OnAfterRoleChange(fn AfterRoleChangeFunc)

func (h *Hooks) OnAfterSessionCreate(fn AfterSessionCreateFunc)

func (h *Hooks) OnAfterSignIn(fn AfterSignInFunc)

func (h *Hooks) OnAfterSignOut(fn AfterSignOutFunc)

func (h *Hooks) OnAfterUserCreate(fn AfterUserCreateFunc)

func (h *Hooks) OnAfterUserUpdate(fn AfterUserUpdateFunc)

func (h *Hooks) OnBeforeRoleChange(fn BeforeRoleChangeFunc)

func (h *Hooks) OnBeforeSessionCreate(fn BeforeSessionCreateFunc)

func (h *Hooks) OnBeforeUserCreate(fn BeforeUserCreateFunc)

func (h *Hooks) OnBeforeUserUpdate(fn BeforeUserUpdateFunc)

func (h *Hooks) RunAfterAPIKeyCreate(ctx context.Context, ev *APIKeyEvent)

func (h *Hooks) RunAfterAPIKeyRevoke(ctx context.Context, ev *APIKeyEvent)

func (h *Hooks) RunAfterAccountLink(ctx context.Context, ev *AccountLink)

func (h *Hooks) RunAfterPasswordChange(ctx context.Context, ev *PasswordChange)

func (h *Hooks) RunAfterRoleChange(ctx context.Context, ev *RoleChange)

func (h *Hooks) RunAfterSessionCreate(ctx context.Context, ev *SessionCreate)

func (h *Hooks) RunAfterSignIn(ctx context.Context, ev *SignIn)

func (h *Hooks) RunAfterSignOut(ctx context.Context, ev *SignOut)

func (h *Hooks) RunAfterUserCreate(ctx context.Context, ev *UserCreate)

func (h *Hooks) RunAfterUserUpdate(ctx context.Context, ev *UserUpdate)

func (h *Hooks) RunBeforeRoleChange(ctx context.Context, ev *RoleChange) error

func (h *Hooks) RunBeforeSessionCreate(ctx context.Context, ev *SessionCreate) error

func (h *Hooks) RunBeforeUserCreate(ctx context.Context, ev *UserCreate) error

func (h *Hooks) RunBeforeUserUpdate(ctx context.Context, ev *UserUpdate) error

type PasswordChange ¶

type PasswordChange struct {
	User *store.User
}

PasswordChange carries a completed password change.

type RoleChange ¶ added in v0.3.0

type RoleChange struct {
	User *store.User
	// From is the role before the change.
	From string
	// To is the role after the change.
	To string
	Tx store.Store
}

RoleChange carries a role change of one user.

Tx is the transactional store in a Before hook. Tx is nil in an After hook.

type SessionCreate ¶

type SessionCreate struct {
	Session *store.Session
	User    *store.User
	Tx      store.Store
}

SessionCreate carries a session creation.

type SignIn ¶

type SignIn struct {
	User    *store.User
	Session *store.Session
	Method  string
}

SignIn carries a completed sign-in. Method names the authentication method, for example "email", "magic-link", or a provider id.

type SignOut ¶

type SignOut struct {
	UserID    string
	SessionID string
}

SignOut carries a completed sign-out.

type UserCreate ¶

type UserCreate struct {
	User *store.User
	Tx   store.Store
}

UserCreate carries a user creation.

Tx is the transactional store in a Before hook. Tx is nil in an After hook.

type UserUpdate ¶ added in v0.3.0

type UserUpdate struct {
	User   *store.User
	Before *store.User
	Tx     store.Store
}

UserUpdate carries a user change.

Before holds the user as it was, and User holds the user after the change. A Before hook can change User, and it can reject the operation.

Tx is the transactional store in a Before hook. Tx is nil in an After hook.