README_SIMPLE_RESOURCE_STORAGE.md

ConstructorOptions

Properties

• client MongoClient? configured mongo client to use. Can be null if url is set
• databaseName string? name of the mongodb database
• collectionName string name of the mongodb collection used to store the resources
• indexes Array<Object>? indexes to be created on instantiation. Use format {key:1} for single indexes and {key1: 1, key:2} for compound indexes. See https://www.mongodb.com/docs/manual/reference/command/createIndexes/#command-fields

Examples

const { MongoClient } = require('mongodb')
const { SimpleResourceStorage } = require('@discue/mongodb-resource-client')

const client = new MongoClient(url, {
  serverApi: { version: '1', strict: true, deprecationErrors: true }, // https://www.mongodb.com/docs/manual/reference/stable-api/
})

const storage = new SimpleResourceStorage({
  client,
  collectionName: 'api_clients',
})

SimpleResourceStorage

Simple resource class with crud operation methods to create, update, delete, and get stored entities and documents.

WithSessionCallback

Type: Function

get

Returns a resource by ids.

Parameters

• resourceIds (String | Array<String>) resource ids that will added to the resource path i.e. /users/${id}/documents/${id}
• options GetOptions

Returns Object

getAll

Returns all resources.

Parameters

• options GetOptions

Returns Array<Object>

getAll

Returns all children of a certain type/collection. Imagine this method walking a tree and returning all leaves at a certain level.

Currently only supports trees with three levels.

Parameters

• resourceIds (String | Array<String>) resource ids that will added to the resource path i.e. /users/${id}/documents/${id}
• childPath (String | Array<String>) the path of the children to query e.g. /api_clients/queues/messages
• options GetChildrenOptions?

Returns Promise<ChildrenAndResourcePaths>

find

• See: README_AGGREGATIONS.md

Returns all resources that pass the given aggregation stages.

Parameters

• aggregations Array<Object> a list of valid aggregation objects (optional, default [])

Returns Array<Object>

exists

Returns true if a resource with given ids exists.

Parameters

• resourceIds (String | Array<String>)

Returns boolean

create

Adds a resource to a collection by ids.

Parameters

• resourceIds (String | Array<String>) resource ids that will added to the resource path i.e. /users/${id}/documents/${id}
• resource Object the resource to be stored

update

Updates a resource by ids.

Parameters

• resourceIds (String | Array<String>) resource ids that will added to the resource path i.e. /users/${id}/documents/${id}
• update Object values that should be updated

delete

Deletes a resource by ids.

Parameters

• resourceIds (String | Array<String>) resource ids that will added to the resource path i.e. /users/${id}/documents/${id}

close

Closes the database client

Returns void