@discue/mongodb-resource-client

mongodb-resource-client

Light wrapper around MongoDB client library to allow for easier management of resources and documents. All storage modules are based on the best practices described in the article 6 Rules of Thumb for MongoDB Schema Design from the official MongoDB blog.

Components

• Aggregations
• EventEmitter
• OneToFewRefStorage
• OneToFewResourceStorage
• OneToManyResourceStorage
• StorageHistory
• SimpleResourceStorage

History / Auditing

The module provides support for history / auditing tables to keep track of changes made to documents. The ResourceStorageHistory component can be used as an extension of a storage instance e.g. SimpleResourceStorage. An instance of ResourceStorageHistory can listen to storage events of another storage instance and populate a ${resourceName}_history collection with timestamp, change type, and the full resource state.

const { EventEmiter } = require('events')
const { OneToFewResourceStorage, ResourceStorageHistory } = require('@discue/mongodb-resource-client')

const eventEmitter = new EventEmitter()
const collectionName = 'api_clients'
const url = 'mongodb://127.0.0.1:27017'

const oneToFewResourceStorage = new OneToFewResourceStorage({
  url,
  collectionName,
  eventEmitter
})

const history = new ResourceStorageHistory({
  url,
  collectionName,
  usageEventPrefix: oneToFewResourceStorage.usageEventPrefix
  eventEmitter
})
history.listenForStorageEvents()

Transactions

The module supports transactions for atomic updates of multiple collections. However, as only MongoDB replica sets support transactions, transaction support needs to be explicitly enabled via setting the environment variable DSQ_MONGOD_ENABLE_TRANSACTIONS with value true.

Installation

npm install @discue/mongodb-resource-client

Run tests

To run tests, run the following command

./test.sh

License

MIT

Changelog

0.8.0 (2023-07-28)

Features

• implement history and auditing extension (05be481)

Chores

• also generate docs for history extension (fc363f4)
• deps-dev: bump eslint from 8.42.0 to 8.44.0 (37cc991)
• deps-dev: bump mongodb-memory-server from 8.12.2 to 8.13.0 (9d2a7f0)
• deps: update dependencies (9e2ef11)
• docs: fix typo (e86a7b1)
• docs: set only one headline in event emitter docs (804d03b)
• docs: update readme (1653c4b)
• docs: update readme (d0f8dde)
• simple-resource: update js doc (6a3b221)
• update docs (df34b9b)
• update jsdoc examples (d111cc0)