dynamoose

What is dynamoose?

Dynamoose is a modeling tool for Amazon's DynamoDB, inspired by Mongoose. It provides a simple and easy-to-use API for defining schemas, models, and performing CRUD operations on DynamoDB tables.

What are dynamoose's main functionalities?

Schema Definition

Dynamoose allows you to define schemas for your DynamoDB tables. This schema definition helps in structuring the data and enforcing data types.

const dynamoose = require('dynamoose');

const UserSchema = new dynamoose.Schema({
  id: String,
  name: String,
  age: Number
});

Model Creation

Once you have defined a schema, you can create a model. This model will be used to interact with the DynamoDB table.

const User = dynamoose.model('User', UserSchema);

CRUD Operations

Dynamoose provides methods for performing CRUD operations. You can create, read, update, and delete items in your DynamoDB table using the model.

const newUser = new User({
  id: '1',
  name: 'John Doe',
  age: 30
});

newUser.save();

User.get('1').then(user => console.log(user));

User.update({ id: '1' }, { age: 31 });

User.delete('1');

Query and Scan

Dynamoose supports querying and scanning the DynamoDB table. You can use various conditions to filter the data.

User.query('name').eq('John Doe').exec().then(users => console.log(users));

User.scan('age').gt(25).exec().then(users => console.log(users));

Other packages similar to dynamoose

aws-sdk

The AWS SDK for JavaScript provides direct access to DynamoDB and other AWS services. It is more low-level compared to Dynamoose and requires more boilerplate code for operations.

vogels

Vogels is another DynamoDB modeling tool inspired by Mongoose. It offers similar functionalities to Dynamoose but is less actively maintained.

README

---

Dynamoose is a modeling tool for Amazon's DynamoDB (inspired by Mongoose).

Dynamoose is Sponsored by Dynobase

Dynobase helps you accelerate your DynamoDB workflow with code generation, faster data exploration, bookmarks and more: https://dynobase.dev/

Getting Started

Take a look at our website for information about how to get started.

Resources

General

• Website
• Sponsor
• Contributing Guide
• Code of Conduct
• Changelog
• License

Social

• Slack
• Twitter

Branch Strategy

Below you will find the current branch strategy for the project. Work taking place on the branches listed below might be further ahead than the versions on NPM. All documentation links found below will also be reflective of the published version on NPM. If you would like to live dangerously and run non-released versions, you can run npm install dynamoose/dynamoose#BRANCH (replacing BRANCH with the branch listed below). You will also find the most up-to-date documentation in the docs folder of the branch.

Branch	Version	NPM Tag	Links
v3	3.0.0	alpha	- Documentation - Pending Changelog
main	2.8.x		- Documentation
v2.8.3 (tag)	2.8.3	latest	- Documentation

Changelog

Version 2.8.3

This release fixes a bug if you started source-map-support yourself where Dynamoose would try to do the same and would lead to conflicts.

Please comment or contact me if you have any questions about this release.

Bug Fixes

• Not registering source-map-support if already initialized.

Other

• Renamed primary branch from master to main.
• Added Node.js v16.x to CI test suite.
• General v3 alpha README fixes.

---