For the given database connectable object db and user identity user-identity returns an account type of the existing user. Optional identity-type can be given to constrain the given identity.

Gets authentication configuration (AuthConfig) for the given user identified by a session object. Uses cached user props provided by amelinium.model.user/prop-of.

Gets authentication configuration (AuthConfig) for the given user. Uses cached user props provided by amelinium.model.user/prop-by-id.

Returns user authentication configuration for the user specified by user-identity and optional identity-type (which can be :email, :phone, :id or :uid). If the identity type is not given it will be guessed.

The resulting map will be an authentication configuration (AuthConfig record) obtained for an account type associated with a user entry, or a generic authentication configuration if account type could not be found because either user does not exist in an authentication database or there is no account type specified for the user.

The returned record will have extra entries present (available only via its map interface):

• :identity/type (detected or given identity type),
• :user/account-type (detected account type or nil if it couldn’t be obtained),
• :user/properties (user properties obtained when querying the database).

Creates new user account identified with the given e-mail email by checking if it was successfully confirmed. Token (token) or code (code) must be provided to authorize operation. Returns a map with :created? set to true if user account is created.

Gets shared suite ID on a basis of its JSON content. If it does not exist, it is created. If the value of suite is a fixed-precision integer, it is returned.

For the given database connectable object db and user identity user-identity returns the existing user’s creation time. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns the existing user’s creator ID. Optional identity-type can be given to constrain the given identity.

Deletes one or more settings for a given user from a database.

For the given database connectable object db and user identity user-identity returns an e-mail of the existing user. Optional identity-type can be given to constrain the given identity.

Returns user identity record (of type amelinium.Identity) if a user specified by the given user-identity with optional identity-type exists. Otherwise it returns nil.

Returns true if a user specified by the given user-identity with optional identity-type exists. Returns false otherwise.

Gets user ID on a basis of a map with :id key or on a basis of a map with :uid key or on a basis of a number, a string or a keyword being ID, email, phone or UID. User must exist in a database. Uses cached properties if possible.

For the given database connectable object db and user identity user-identity returns a first name of the existing user. Optional identity-type can be given to constrain the given identity.

Creates a password for the given authentication config. Returns a map of shared part ID and an intrinsic part as two keys: password-suite-id and :password.

Takes a user identity user-identity and a database connectable object and returns a numerical user ID (not cached). Optional identity type will constrain the identity to be treated as it will be of certain type.

This function is using query-id to perform the actual query on a database using identity record created with amelinium.identify/of or amelinium.identity/of-type.

This function is used by cache-backed functions id, id-of, trusted-id and trusted-id-of to communicate with a database.

Takes user identities and a database connectable object, and returns a numerical user IDs (not cached). Optional identity type will constrain the identity to be treated as it will be of certain type. Returns a map with amelinium.Identity objects as keys and numerical identifiers as values.

This function is using query-ids to perform the actual query on a database using identity records created with amelinium.identify/of or amelinium.identity/of-type.

This function is used by cache-backed functions ids, ids-of, trusted-ids and trusted-ids-of to communicate with a database.

Returns data required for user to log in, including password information.

Returns password information.

Gets user setting and de-serializes it to a Clojure data structure.

Gets shared suite by its ID as a JSON string.

Gets shared suite ID on a basis of its JSON content. If the value of suite is a fixed-precision integer, it is returned.

Given an email, returns the user data in a form of lazy map.

Given a user ID, returns the user data in a form of lazy map.

Given a database connectable object db and a UID uid, returns the user data in a form of lazy map.

For the given database connectable object db and user identity user-identity returns a time of the account’s hard-lock (if any). Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a time of the account’s hard-lock (if any). Optional identity-type can be given to constrain the given identity.

Takes a user identity, optional identity type and a database connectable object, and returns a numerical user ID (cached).

Optional identity type will constrain the identity to be treated as it will be of certain type.

Like id but identity-type is a first argument.

Takes user identities, optional identity type and a database connectable object, and returns a map with amelinium.Identity keys and numerical user IDs values (cached).

Optional identity type will constrain the identities to be treated as they will be of certain type.

Like ids but identity-type is a first argument.

For the given database connectable object db and user identity user-identity returns a time of last log-in attempt of the existing user. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a last IP address from which the user has failed to log in successfully. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a time of last successful log-in of the existing user. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a last name of the existing user. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a last IP address from which the user has logged in successfully. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a number of login attempts of the existing user. Optional identity-type can be given to constrain the given identity.

Creates user data record by getting values from the given authentication settings and parameters map. If :password parameter is present it will make JSON password suite.

Creates simple user data record (only db, phone and email) by getting values from the given authentication settings and parameters map.

Creates user password (of type PasswordData) on a basis of authentication source auth-src, a plain password string password and optional account type account-type.

Authentication source can be a request map, AuthSettings record or AuthConfig record. If this is a request map then authentication settings are looked up under the :auth/setup key.

The account-type argument is used to select authentication configuration (of type AuthConfig) specific to a user from the given or obtained authentication settings.

If account-type argument is not given and the given authentication source is not of type AuthConfig then the default authentication configuration associated with detected authentication settings is used.

If account-type argument is not given or is set to nil or false, and the given authentication source is already of type AuthConfig then it has no impact on the authentication configuration being used.

If account-type argument is given and is not nil or false, and the given authentication source is already of type AuthConfig then it will be used only if it is configured to handle the given account type. If it is does not, password data record with nil values associated with each field is returned.

For the given database connectable object db and user identity user-identity returns a middle name of the existing user. Optional identity-type can be given to constrain the given identity.

For the given database connectable object db and user identity user-identity returns a phone number of the existing user. Optional identity-type can be given to constrain the given identity.

Creates a password suites without saving it into a database. Uses database to store the given, shared password suite if it does not exist yet. Returns a map with two keys: :password (JSON-encoded password ready to be saved into a database which should be given as an argument) and :password-suite-id (integer identifier of a shared suite ID which exists on a database).

For the given database connectable object db, property identifier prop-id, and identifiable object user-identity, returns user’s property. If multiple identities are given, returns a map of amelinium.Identity records associated with selected property values. (cached)

Returns user property prop-id for the given user ID user-id or a map of user properties keyed with their IDs if multiple IDs are given (cached).

Returns user property prop for the given user ID id or a map of user property keyed with its ID if multiple IDs are given (cached). If the property is not found the default value, given as default, is returned instead of nil.

Returns property prop-id for the given user IDs ids (cached).

Deletes property of a user with the given ID user-id by setting it to nil.

Using the database connectable object db, returns the hard-lock status for the user account of the given ID user-id. Uses cached property.

For the given identity type identity-type, database connectable object db, property identifier prop-id, and identifiable object user-identity, returns user’s property. If multiple identities are given, returns a map of amelinium.Identity records associated with selected property values. Identity type(s) must be of the given type. (cached)

Sets property k of a user identified with the given ID user-id to value v.

For the given database connectable object db and identifiable object user-identity, returns user’s properties as a map. If multiple identities are given, returns a sequence of maps. (cached)

Returns user properties for the given user ID user-id (cached).

Returns user properties for each of the given user IDs ids (cached).

Deletes all properties of a user identified with the given ID user-id.

For the given database connectable object db, identity type identity-type and identifiable object user-identity, returns user’s properties as a map. If multiple identities are given, returns a map keyed with amelinium.Identity records. The given identity must be of the given type. (cached)

Sets properties of a user identified with the given ID user-id.

Stores one or more settings of the given user in a database. Maximum object size is 32 KB.

Performs an ID-getting query for the given identity and identity type (must be a keyword). This method is used to get user ID for the given identity of a known type.

Converts the given user identity user-identity to a database-suitable value and then performs a SQL query query with the obtained value as a parameter. Returns query result as vector. This is a standard querying function applicable to many simple database schemas. Used primarily as a default operation in method definitions of query-id.

Performs a multiple IDs-getting SQL query for the given identity and identity type (must be a keyword). This method is used to get user IDs for the given identities of known types.

Converts the given user identities user-identities to a database-suitable values and then performs a SQL query query with the obtained value as parameters added using “IN(…)” clause. Returns query result as vector. Used primarily as a default operation in method definitions of query-ids.

For the given database connectable object db, property identifier prop-id, optional identity type identity-type and identifiable objects user-identities, returns a map of amelinium.Identity records associated with selected property values. Each given identity must be of the given type if identity-type is used. (cached)

Returns user property prop-id for the given user IDs user-ids (cached).

The same as seq-prop but identity-type is a mandatory first argument. (cached)

For the given database connectable object db, optional identity type identity-type and identifiable object user-identity, returns users’ properties as map keyed with amelinium.Identity records. The given identities must be of the given type if the type is given. (cached)

Returns user properties for each of the given user IDs ids (cached).

For the given database connectable object db and user identity user-identity returns a session of the existing user. Optional identity-type can be given to constrain the given identity.

Be aware that this operation will only work if the identity type is a session. There is no parsing of session ID, nor getting it from a database.

For the given database connectable object db and user identity user-identity returns a time of the account’s soft-lock (if any). Optional identity-type can be given to constrain the given identity.

Takes a user identity, optional identity type and a database connectable object, and returns a numerical user ID (cached).

When the given identity is of type :id (a numerical identifier), it will NOT interact with a database but simply trust that the ID exists and will simply return it.

Optional identity type will constrain the identity to be treated as it will be of certain type.

Like trusted-id but identity-type is a first argument.

Takes user identities, optional identity type and a database connectable object, and returns a map with amelinium.Identity keys and numerical user IDs values (cached).

When any of the given identities is of type :id (a numerical identifier), it will NOT interact with a database to get the ID but simply trust that this ID exists and will simply put it into a map.

Optional identity type will constrain the identities to be treated as they will be of certain type.

Like trusted-ids but identity-type is a first argument.

For the given database connectable object db and user identity user-identity returns a UID of the existing user. Optional identity-type can be given to constrain the given identity.

Updates user’s identity identified by user-identity and code, or by token. Code or token must exist in a database.

Updates users table with failed login data (attempts, IP address) according to authentication configuration and sets a soft lock if a number of attempts exceeded the configured value.

Updates password information for the given user by updating suite ID and intrinsic password in an authorization database. Additionally :last_attempt and :last_failed_ip properties are deleted and :login_attempts is set to 0.