JSPM

  • Created
  • Published
  • Downloads 1225
  • Score
    100M100P100Q130808F
  • License MIT

Dynamode is a modeling tool for Amazon's DynamoDB

Package Exports

    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.