@brianmmdev/faunaservice

1.0.5 • Public • Published

FaunaService

FaunaService is a small wrapper around basic CRUD operations for FaunaDB. It makes performing these simple operations extremely easy and intuitive.

Note: This library is provided with absolutely no guarantees from myself or any contributors.

How to Use

Install the Package

npm install @brianmmdev/faunaservice

Creating the Service Instance

The service is exported as a class, so you'll need to create an instance to use it. Pass in your Fauna secret for your database.

// Import the library
const FaunaService = require('@brianmmdev/faunaservice')

// New up an instance, passing in your Fauna secret
const _faunaService = new FaunaService('MY_FAUNA_SECRET')

Adding a Record

let myData = {
  firstName: 'Brian',
  lastName: 'Morrison'
}

let createdRecord = await _faunaService.createRecord('COLLECTION_NAME', myData);

// Returns:
// {
//   id: '123123123123', // This is the ref id
//   firstName: 'Brian',
//   lastName: 'Morrison'
// }

Update a Record

Updating a record will only update the specific values passed in.

let recordId = '123123123123'
let myUpdates = {
  firstName: 'Luca'
}

let updatedRecord = await _faunaService.updateRecord('COLLECTION_NAME', recordId, myUpdates)

// Returns:
// {
//   id: '123123123123',
//   firstName: 'Luca',
//   lastName: 'Morrison'
// }

Get a Single Record

The result will be a flattened version of the record (meaning the Ref ID will be returned as id in the data)

let recordId = '123123123123'
let record = await _faunaService.getRecordById('COLLECTION_NAME', recordId)

// Returns:
// {
//   id: '123123123123',
//   firstName: 'Luca',
//   lastName: 'Morrison'
// }

List Records in a Collection

The result will be an array of flattened records, same as above.

let records = await _faunaService.listRecords('COLLECTION_NAME')

// Returns:
// [{
//   id: '123123123123',
//   firstName: 'Luca',
//   lastName: 'Morrison'
// }]

Delete a Record

Deleting a record will not return any values.

let recordId = '123123123123'
await _faunaService.deleteRecord('COLLECTION_NAME', recordId)

Contributing

To contribute, follow standard GitHub contribution guidelines:

  1. Fork the repo
  2. Make changes
  3. Create a pull request.
  4. ???
  5. Profit! (Not really...)

Support

If you have questions, the best way to contact me is through my Discord, fullstack.chat

Readme

Keywords

none

Package Sidebar

Install

npm i @brianmmdev/faunaservice

Weekly Downloads

3

Version

1.0.5

License

MIT

Unpacked Size

7.15 kB

Total Files

3

Last publish

Collaborators

  • brianmmdev