bedrock-account

bedrock-account

User accounts for Bedrock Applications

API Reference

bedrock-account

• bedrock-account
  • .insert(options) ⇒ Promise
  • .exists(options) ⇒ Promise
  • .get(options) ⇒ Promise
  • .getAll(options) ⇒ Promise
  • .update(options) ⇒ Promise
  • .setStatus(options) ⇒ Promise

bedrock-account.insert(options) ⇒ Promise

Inserts a new account. The account must contain id.

Kind: static method of bedrock-account
Returns: Promise - Resolves to the database account record.

Param	Type	Description
options	object	The options to use.
options.account	object	The account containing at least the minimum required data.
[options.meta]	object	The meta information to include.

bedrock-account.exists(options) ⇒ Promise

Check for the existence of an account.

Kind: static method of bedrock-account
Returns: Promise - Resolves to a boolean indicating account existence.

Param	Type	Default	Description
options	object		The options to use.
[options.id]	string		The ID of the account to check.
[options.email]	string		The email address for the account.
[options.status]	string	"active"	The status to check for (options: 'active', deleted').

bedrock-account.get(options) ⇒ Promise

Retrieves an account.

Kind: static method of bedrock-account
Returns: Promise - Resolves to {account, meta}.

Param	Type	Description
options	object	The options to use.
options.id	string	The ID of the account to retrieve.

bedrock-account.getAll(options) ⇒ Promise

Retrieves all accounts matching the given query.

Kind: static method of bedrock-account
Returns: Promise - Resolves to the records that matched the query.

Param	Type	Default	Description
options	object		The options to use.
[options.query]	object	{}	The query to use.
[options.options]	object	{}	The options (eg: 'sort', 'limit').

bedrock-account.update(options) ⇒ Promise

Updates an account.

Kind: static method of bedrock-account
Returns: Promise - Resolves once the operation completes.

Param	Type	Description
options	object	The options to use.
options.id	string	The ID of the account to update.
options.patch	Array	A JSON patch for performing the update.
options.sequence	number	The sequence number that must match the current record prior to the patch.

bedrock-account.setStatus(options) ⇒ Promise

Sets an account's status.

Kind: static method of bedrock-account
Returns: Promise - Resolves once the operation completes.

Param	Type	Description
options	object	The options to use.
options.id	string	The account ID.
options.status	string	The status.

Changelog

6.0.0 - 2022-03-07

Changed

• BREAKING: Remove deprecated fields option from getAll. Use options.projection instead.
• BREAKING: Update peer deps:
  • bedrock@4.4
  • bedrock-validation@5.5
  • bedrock-mongodb@8.4

Removed

• BREAKING: Remove all usage of bedrock-permission including roles (e.g., sysResourceRole), actor, etc. All authz should be managed via HTTP (or other) APIs and technologies such as zcaps, meters, and oauth2.