JSPM

  • Created
  • Published
  • Downloads 1114
  • Score
    100M100P100Q131265F
  • License MIT

Dynamode is a modeling tool for Amazon's DynamoDB

Package Exports

  • dynamode
  • dynamode/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (dynamode) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Dynamode

npm License npm Downloads stars


Dynamode is a modeling tool for Amazon's DynamoDB. Its goal is to ease the use of DynamoDB without its quirks and emphasize DynamoDB advantages over other databases. Dynamode provides a straightforward, object-oriented class-based solution to model your data. It includes strongly typed classes and methods, query and scan builders, and much more.

Dynamode is highly influenced by other ORMs/ODMs, such as TypeORM, Dynamoose and Mongoose.

Documentation

Check out our dedicated documentation page here for info about the library, guide and more.

Installation

Check out the installation section of our docs for the detailed installation instructions.

License

Dynamode is licensed under The MIT License.

Examples

Example table definition:

type ExampleTableProps = {
  propPk: string;
  propSk: number;
  index: string;
};

const TABLE_NAME = 'example-table';

class ExampleTable extends Entity {
  @attribute.partitionKey.string()
  propPk: string;

  @attribute.sortKey.number()
  propSk: number;

  @attribute.lsi.sortKey.string({ indexName: 'LSI_NAME' })
  index: string;

  constructor(props: ExampleTableProps) {
    super();

    this.propPk = props.propPk;
    this.propSk = props.propSk;
    this.index = props.index;
  }
}

export const ExampleTableManager = new TableManager(ExampleTable, {
  tableName: TABLE_NAME,
  partitionKey: 'propPk',
  sortKey: 'propSk',
  indexes: {
    LSI_NAME: {
      sortKey: 'index',
    },
  },
});

await ExampleTableManager.create();

Example entity definition:

type ExampleEntityProps = ExampleTableProps & {
  attr: { [k: string]: number };
};

export class ExampleEntity extends ExampleTable {
  @attribute.object()
  attr: { [k: string]: number };

  constructor(props: ExampleEntityProps) {
    super(props);

    this.attr = props.attr;
  }
}

export const ExampleEntityManager = ExampleTableManager.entityManager(ExampleEntity);

await ExampleEntityManager.put(new ExampleEntityManager({ ... }));

Find more examples under the examples/ directory.