Added all examples from documentation for testing/added more typings

This commit is contained in:
Evan Moran
2017-11-12 10:33:29 -05:00
parent 08d7674c3e
commit afb9a5f9d3
2 changed files with 939 additions and 35 deletions
+827 -17
View File
@@ -1,30 +1,840 @@
/// <reference path="index.d.ts" />
import * as dynogels from "dynogels";
import dynogels = require("dynogels");
import { DynamoDB } from "aws-sdk";
dynogels.AWS;
import * as Joi from "joi";
dynogels.log.info("test", "123", {});
dynogels.log.warn("test", "123", {});
//AWS Configs
dynogels.AWS.config.loadFromPath('credentials.json');
dynogels.AWS.config.update({ region: "REGION" });
var dynamoDb = new DynamoDB();
dynamoDb.getItem()
dynogels.dynamoDriver(dynamoDb);
dynogels.reset();
var model = dynogels.define("asdfas", {
hashKey: "Asdf", schema: {
//Define a Model
var Account = dynogels.define('Account', {
hashKey: 'email',
// add the timestamp attributes (updatedAt, createdAt)
timestamps: true,
schema: {
email: Joi.string().email(),
name: Joi.string(),
age: Joi.number(),
roles: dynogels.types.stringSet(),
settings: {
nickname: Joi.string(),
acceptedTerms: Joi.boolean().default(false),
test: {
evan: Joi.string()
}
}
}
});
let a = new model({ test: 12312 });
var BlogPost = dynogels.define('BlogPost', {
hashKey: 'email',
rangeKey: 'title',
schema: {
email: Joi.string().email(),
title: Joi.string(),
content: Joi.binary(),
tags: dynogels.types.stringSet(),
}
});
var BlogPost = dynogels.define('BlogPost', {
hashKey: 'email',
rangeKey: 'title',
schema: {
email: Joi.string().email(),
title: Joi.string()
},
validation: {
// allow properties not defined in the schema
allowUnknown: true
}
});
model.get("asdfas,", (err, test) => {
//Create Tables
dynogels.createTables(function (err) {
if (err) {
console.log('Error creating tables: ', err);
} else {
console.log('Tables has been created');
}
});
dynogels.createTables({
'BlogPost': { readCapacity: 5, writeCapacity: 10 },
'Account': {
readCapacity: 20,
writeCapacity: 4,
streamSpecification: {
streamEnabled: true,
streamViewType: 'NEW_IMAGE'
}
}
}, function (err) {
if (err) {
console.log('Error creating tables: ', err);
} else {
console.log('Tables has been created');
}
});
dynogels.createTables({
$dynogels: { pollingInterval: 100 }
}, function (err) {
if (err) {
console.log('Error creating tables: ', err);
} else {
console.log('Tables has been created');
}
});
// Delete Table
BlogPost.deleteTable(function (err) {
if (err) {
console.log('Error deleting table: ', err);
} else {
console.log('Table has been deleted');
}
});
//UUID
var Tweet = dynogels.define('Tweet', {
hashKey: 'TweetID',
timestamps: true,
schema: {
TweetID: dynogels.types.uuid(),
content: Joi.string(),
}
});
//Configuration
var Account = dynogels.define('Account', {
hashKey: 'email',
// add the timestamp attributes (updatedAt, createdAt)
timestamps: true,
schema: {
email: Joi.string().email(),
}
});
var Account = dynogels.define('Account', {
hashKey: 'email',
// enable timestamps support
timestamps: true,
// I don't want createdAt
createdAt: false,
// I want updatedAt to actually be called updateTimestamp
updatedAt: 'updateTimestamp',
schema: {
email: Joi.string().email(),
}
});
var Event = dynogels.define('Event', {
hashKey: 'name',
schema: {
name: Joi.string(),
total: Joi.number()
},
tableName: 'deviceEvents'
});
var Event = dynogels.define('Event', {
hashKey: 'name',
schema: {
name: Joi.string(),
total: Joi.number()
},
// store monthly event data
tableName: function () {
var d = new Date();
return ['events', d.getFullYear(), d.getMonth() + 1].join('_');
}
});
Account.config({ tableName: 'AccountsTable' });
var dynamodb = new DynamoDB();
Account.config({ dynamodb: dynamodb });
// or globally use custom DynamoDB instance
// all defined models will now use this driver
dynogels.dynamoDriver(dynamodb);
// Saving Models To DynamoDB
Account.create({ email: 'foo@example.com', name: 'Foo Bar', age: 21 }, function (err, acc) {
console.log('created account in DynamoDB', acc.get('email'));
});
var acc = new Account({ email: 'test@example.com', name: 'Test Example' });
acc.save(function (err) {
console.log('created account in DynamoDB', acc.get('email'));
});
BlogPost.create({
email: 'werner@example.com',
title: 'Expanding the Cloud',
content: 'Today, we are excited to announce the limited preview...'
}, function (err, post) {
console.log('created blog post', post.get('title'));
});
var item1 = { email: 'foo1@example.com', name: 'Foo 1', age: 10 };
var item2 = { email: 'foo2@example.com', name: 'Foo 2', age: 20 };
var item3 = { email: 'foo3@example.com', name: 'Foo 3', age: 30 };
Account.create([item1, item2, item3], function (err, accounts) {
console.log('created 3 accounts in DynamoDB', accounts);
});
var params: dynogels.CreateItemOptions = {
};
params.ConditionExpression = '#i <> :x';
params.ExpressionAttributeNames = { '#i': 'id' };
params.ExpressionAttributeValues = { ':x': 123 };
Account.create({ id: 123, name: 'Kurt Warner' }, params, function (error, acc) {
});
model.create({}, (err, data) => {
var a = data.get("hello");
a.asdfs = 1;
data.set({ test: "12312" });
})
// setting overwrite to false will generate
// the same Condition Expression as in the previous example
Account.create({ id: 123, name: 'Kurt Warner' }, { overwrite: false }, function (error, acc) { });
// Updating
Account.update({ email: 'foo@example.com', name: 'Bar Tester' }, function (err, acc) {
console.log('update account', acc.get('name'));
});
Account.update({ email: 'foo@example.com', name: 'Bar Tester' }, { ReturnValues: 'ALL_OLD' }, function (err, acc) {
console.log('update account', acc.get('name')); // prints the old account name
});
// Only update the account if the current age of the account is 22
Account.update({ email: 'foo@example.com', name: 'Bar Tester' }, { expected: { age: 22 } }, function (err, acc) {
console.log('update account', acc.get('name'));
});
// setting an attribute to null will delete the attribute from DynamoDB
Account.update({ email: 'foo@example.com', age: null }, function (err, acc) {
console.log('update account', acc.get('age')); // prints null
});
Account.update(
{ email: 'foo@example.com', name: 'FooBar Testers' },
{ expected: { email: { Exists: true } } },
(err, acc) => {
console.log(acc.get('name')); // FooBar Testers
}
);
Account.update(
{ email: 'baz@example.com', name: 'Bar Tester' },
{ expected: { email: { Exists: true } } },
(err, acc) => {
console.log(err); // Condition Expression failed: no Account with that hash key
}
);
Account.update({ email: 'foo@example.com', age: { $add: 1 } }, function (err, acc) {
console.log('incremented age by 1', acc.get('age'));
});
BlogPost.update({
email: 'werner@example.com',
title: 'Expanding the Cloud',
tags: { $add: 'cloud' }
}, function (err, post) {
console.log('added single tag to blog post', post.get('tags'));
});
BlogPost.update({
email: 'werner@example.com',
title: 'Expanding the Cloud',
tags: { $add: ['cloud', 'dynamodb'] }
}, function (err, post) {
console.log('added tags to blog post', post.get('tags'));
});
BlogPost.update({
email: 'werner@example.com',
title: 'Expanding the Cloud',
tags: { $del: 'cloud' }
}, function (err, post) {
console.log('removed cloud tag from blog post', post.get('tags'));
});
BlogPost.update({
email: 'werner@example.com',
title: 'Expanding the Cloud',
tags: { $del: ['aws', 'node'] }
}, function (err, post) {
console.log('removed multiple tags', post.get('tags'));
});
var params1: dynogels.UpdateItemOptions = {};
params1.UpdateExpression = 'SET #year = #year + :inc, #dir.titles = list_append(#dir.titles, :title), #act[0].firstName = :firstName ADD tags :tag';
params1.ConditionExpression = '#year = :current';
params1.ExpressionAttributeNames = {
'#year': 'releaseYear',
'#dir': 'director',
'#act': 'actors'
};
params1.ExpressionAttributeValues = {
':inc': 1,
':current': 2001,
':title': ['The Man'],
':firstName': 'Rob',
':tag': dynogels.Set(['Sports', 'Horror'], 'S')
};
BlogPost.update({ title: 'Movie 0', description: 'This is a description' }, params1, function (err, mov) { });
//Deleting
Account.destroy('foo@example.com', function (err) {
console.log('account deleted');
});
// Destroy model using hash and range key
BlogPost.destroy('foo@example.com', 'Hello World!', function (err) {
console.log('post deleted')
});
BlogPost.destroy({ email: 'foo@example.com', title: 'Another Post' }, function (err) {
console.log('another post deleted')
});
Account.destroy('foo@example.com', { ReturnValues: 'ALL_OLD' }, function (err, acc) {
console.log('account deleted');
console.log('deleted account name', acc.get('name'));
});
Account.destroy('foo@example.com', { expected: { age: 22 } }, function (err) {
console.log('account deleted if the age was 22');
});
var params2: dynogels.DestroyItemOptions = {};
params2.ConditionExpression = '#v = :x';
params2.ExpressionAttributeNames = { '#v': 'version' };
params2.ExpressionAttributeValues = { ':x': '2' };
Account.destroy({ id: 123 }, params2, function (err, acc) { });
//Loading Models from DynamoDB
Account.get('test@example.com', function (err, acc) {
console.log('got account', acc.get('email'));
});
Account.get('test@example.com', { ConsistentRead: true }, function (err, acc) {
console.log('got account', acc.get('email'));
});
Account.get('test@example.com', { ConsistentRead: true, AttributesToGet: ['name', 'age'] }, function (err, acc) {
console.log('got account', acc.get('email'))
console.log(acc.get('name'));
console.log(acc.get('age'));
console.log(acc.get('email')); // prints null
});
BlogPost.get('werner@example.com', 'dynamodb-keeps-getting-better-and-cheaper', function (err, post) {
console.log('loaded post by range and hash key', post.get('content'));
});
BlogPost.get({ email: 'werner@example.com', title: 'Expanding the Cloud' }, function (err, post) {
console.log('loded post', post.get('content'));
});
BlogPost.get({ id: '123456789' }, { ProjectionExpression: 'email, age, settings.nickname' }, function (err, acc) { });
// Query
var callback = () => { };
// query for blog posts by werner@example.com
BlogPost
.query('werner@example.com')
.exec(callback);
// same as above, but load all results
BlogPost
.query('werner@example.com')
.loadAll()
.exec(callback);
// only load the first 5 posts by werner
BlogPost
.query('werner@example.com')
.limit(5)
.exec(callback);
// query for posts by werner where the tile begins with 'Expanding'
BlogPost
.query('werner@example.com')
.where('title').beginsWith('Expanding')
.exec(callback);
// return only the count of documents that begin with the title Expanding
BlogPost
.query('werner@example.com')
.where('title').beginsWith('Expanding')
.select('COUNT')
.exec(callback);
// query the first 10 posts by werner@example.com but only return
// the title and content from posts where the title starts with 'Expanding'
// WARNING: See notes below on the implementation of limit in DynamoDB
BlogPost
.query('werner@example.com')
.where('title').beginsWith('Expanding')
.attributes(['title', 'content'])
.limit(10)
.exec(callback);
// sorting by title ascending
BlogPost
.query('werner@example.com')
.ascending()
.exec(callback)
// sorting by title descending
BlogPost
.query('werner@example.com')
.descending()
.exec(callback)
// All query options are chainable
BlogPost
.query('werner@example.com')
.where('title').gt('Expanding')
.attributes(['title', 'content'])
.limit(10)
.ascending()
.loadAll()
.exec(callback);
// Traversing Map Data Types
Account
.query('werner@example.com')
.filter('settings.acceptedTerms').equals(true)
.exec(callback);
BlogPost
.query('werner@example.com')
.where('title').equals('Expanding')
.exec();
// less than equals
BlogPost
.query('werner@example.com')
.where('title').lte('Expanding')
.exec();
// less than
BlogPost
.query('werner@example.com')
.where('title').lt('Expanding')
.exec();
// greater than
BlogPost
.query('werner@example.com')
.where('title').gt('Expanding')
.exec();
// greater than equals
BlogPost
.query('werner@example.com')
.where('title').gte('Expanding')
.exec();
// attribute doesn't exist
BlogPost
.query('werner@example.com')
.where('title').null()
.exec();
// attribute exists
BlogPost
.query('werner@example.com')
.where('title').exists()
.exec();
BlogPost
.query('werner@example.com')
.where('title').beginsWith('Expanding')
.exec();
BlogPost
.query('werner@example.com')
.where('title').between('foo@example.com', 'test@example.com')
.exec();
BlogPost
.query('werner@example.com')
.where('title').equals('Expanding')
.filter('tags').contains('cloud')
.exec();
BlogPost
.query('werner@example.com')
.filterExpression('#title < :t')
.expressionAttributeValues({ ':t': 'Expanding' })
.expressionAttributeNames({ '#title': 'title' })
.projectionExpression('#title, tag')
.exec();
var GameScore = dynogels.define('GameScore', {
hashKey: 'userId',
rangeKey: 'gameTitle',
schema: {
userId: Joi.string(),
gameTitle: Joi.string(),
topScore: Joi.number(),
topScoreDateTime: Joi.date(),
wins: Joi.number(),
losses: Joi.number()
},
indexes: [{
hashKey: 'gameTitle', rangeKey: 'topScore', name: 'GameTitleIndex', type: 'global'
}]
});
GameScore
.query('Galaxy Invaders')
.usingIndex('GameTitleIndex')
.descending()
.exec(callback);
var GameScore = dynogels.define('GameScore', {
hashKey: 'userId',
rangeKey: 'gameTitle',
schema: {
userId: Joi.string(),
gameTitle: Joi.string(),
topScore: Joi.number(),
topScoreDateTime: Joi.date(),
wins: Joi.number(),
losses: Joi.number()
},
indexes: [{
hashKey: 'gameTitle',
rangeKey: 'topScore',
name: 'GameTitleIndex',
type: 'global',
projection: { NonKeyAttributes: ['wins'], ProjectionType: 'INCLUDE' } //optional, defaults to ALL
}]
});
GameScore
.query('Galaxy Invaders')
.usingIndex('GameTitleIndex')
.where('topScore').gt(1000)
.descending()
.exec((err, data) => {
});
var BlogPost = dynogels.define('Account', {
hashKey: 'email',
rangeKey: 'title',
schema: {
email: Joi.string().email(),
title: Joi.string(),
content: Joi.binary(),
PublishedDateTime: Joi.date()
},
indexes: [{
hashKey: 'email', rangeKey: 'PublishedDateTime', type: 'local', name: 'PublishedIndex'
}]
});
BlogPost
.query('werner@example.com')
.usingIndex('PublishedIndex')
.descending()
.exec(callback);
BlogPost
.query('werner@example.com')
.usingIndex('PublishedIndex')
.ascending()
.exec(callback);
BlogPost
.query('werner@example.com')
.usingIndex('PublishedIndex')
.descending()
.loadAll()
.exec(callback);
// scan all accounts, returning the first page or results
Account.scan().exec(callback);
// scan all accounts, this time loading all results
// note this will potentially make several calls to DynamoDB
// in order to load all results
Account
.scan()
.loadAll()
.exec(callback);
// Load 20 accounts
Account
.scan()
.limit(20)
.exec();
// Load All accounts, 20 at a time per request
Account
.scan()
.limit(20)
.loadAll()
.exec();
// Load accounts which match a filter
// only return email and created attributes
// and return back the consumed capacity the request took
Account
.scan()
.where('email').gte('f@example.com')
.attributes(['email', 'created'])
.returnConsumedCapacity()
.exec();
// Load All accounts, if settings.acceptedTerms is true
Account
.scan()
.where('settings.acceptedTerms').equals(true)
.exec();
// Returns number of matching accounts, rather than the matching accounts themselves
Account
.scan()
.where('age').gte(21)
.select('COUNT')
.exec();
// Start scan using start key
Account
.scan()
.where('age').notNull()
.startKey('foo@example.com')
.exec()
// equals
Account
.scan()
.where('name').equals('Werner')
.exec();
// not equals
Account
.scan()
.where('name').ne('Werner')
.exec();
// less than equals
Account
.scan()
.where('name').lte('Werner')
.exec();
// less than
Account
.scan()
.where('name').lt('Werner')
.exec();
// greater than equals
Account
.scan()
.where('name').gte('Werner')
.exec();
// greater than
Account
.scan()
.where('name').gt('Werner')
.exec();
// name attribute doesn't exist
Account
.scan()
.where('name').null()
.exec();
// name attribute exists
Account
.scan()
.where('name').notNull()
.exec();
// contains
Account
.scan()
.where('name').contains('ner')
.exec();
// not contains
Account
.scan()
.where('name').notContains('ner')
.exec();
// in
Account
.scan()
.where('name').in(['foo@example.com', 'bar@example.com'])
.exec();
// begins with
Account
.scan()
.where('name').beginsWith('Werner')
.exec();
// between
Account
.scan()
.where('name').between('Bar', 'Foo')
.exec();
// multiple filters
Account
.scan()
.where('name').equals('Werner')
.where('age').notNull()
.exec();
Account.scan()
.filterExpression('#age BETWEEN :low AND :high AND begins_with(#email, :e)')
.expressionAttributeValues({ ':low': 18, ':high': 22, ':e': 'test1' })
.expressionAttributeNames({ '#age': 'age', '#email': 'email' })
.projectionExpression('#age, #email')
.exec();
var totalSegments = 8;
Account.parallelScan(totalSegments)
.where('age').gte(18)
.attributes('age')
.exec(callback);
// Load All accounts
Account
.parallelScan(totalSegments)
.exec()
Account.getItems(['foo@example.com', 'bar@example.com', 'test@example.com'], function (err, accounts) {
console.log('loaded ' + accounts.length + ' accounts'); // prints loaded 3 accounts
});
// Get both accounts, using a consistent read
Account.getItems(['foo@example.com', 'bar@example.com'], { ConsistentRead: true }, function (err, accounts) {
console.log('loaded ' + accounts.length + ' accounts'); // prints loaded 2 accounts
});
//Streaming API
var stream = Account.parallelScan(4).exec();
stream.on('readable', function () {
console.log('single parallel scan response', stream.read());
});
stream.on('end', function () {
console.log('Parallel scan of accounts finished');
});
var querystream = BlogPost.query('werner@dynogels.com').loadAll().exec();
querystream.on('readable', function () {
console.log('single query response', stream.read());
});
querystream.on('end', function () {
console.log('query for blog posts finished');
});
//Dynamic Table Names
var Event = dynogels.define('Event', {
hashKey: 'name',
schema: {
name: Joi.string(),
total: Joi.number()
},
// store monthly event data
tableName: function () {
var d = new Date();
return ['events', d.getFullYear(), d.getMonth() + 1].join('_');
}
});
// Logging
const accountLogger = {
info: (...args: any[]) => {
},
warn: (...args: any[]) => {
}
}
dynogels.log = accountLogger;
var Account = dynogels.define('Account', {
hashKey: 'email',
log: accountLogger
}); // INFO level on account table
var Account = dynogels.define('Account', {
hashKey : 'email',
// add the timestamp attributes (updatedAt, createdAt)
timestamps : true,
schema : {
email : Joi.string().email(),
name : Joi.string().required(),
age : Joi.number(),
}
});
Account.create({email: 'test@example.com', name : 'Test Account'}, function (err, acc) {
console.log('created account at', acc.get('created')); // prints created Date
acc.set({age: 22});
acc.update(function (err) {
console.log('updated account age');
});
});
// For models with range keys you must pass in objects of hash and range key attributes
var postKey1 = { email: 'test@example.com', title: 'Hello World!' };
var postKey2 = { email: 'test@example.com', title: 'Another Post' };
BlogPost.getItems([postKey1, postKey2], function (err, posts) {
console.log('loaded posts');
});
dynogels.log.info("test", "123", {});
dynogels.log.warn("test", "123", {});
+112 -18
View File
@@ -4,29 +4,59 @@
// Definitions: https://github.com/DefinitelyTyped/DefinitelyTyped
export import AWS = require("aws-sdk");
import * as joi from "joi";
import stream = require("stream");
export namespace log {
function info(...args: any[]): void;
function warn(...args: any[]): void;
export let log: Log;
interface Log {
info(...args: any[]): void;
warn(...args: any[]): void;
}
export let models: { [key: string]: any };
export function dynamoDriver(dynamoDB: AWS.DynamoDB): AWS.DynamoDB;
export function reset(): void;
export function define(modelName: string, config: ModelConfiguration): Model;
export function createTables(callback: (err: string) => void): any;
export function createTables(callback: (err: string) => void): void;
export function createTables(options: { [key: string]: CreateTablesOptions } | DynogelsGlobalOptions, callback: (err: string) => void): void;
export function Set(...args: any[]): any;
type DynogelsGlobalOptions = {
$dynogels: {
pollingInterval: number;
}
};
interface CreateTablesOptions {
readCapacity?: number;
writeCapacity?: number;
streamSpecification?: {
streamEnabled: boolean;
streamViewType: string;
};
}
export let types: {
stringSet(): joi.AnySchema;
numberSet(): joi.AnySchema;
binarySet(): joi.AnySchema;
uuid(): joi.AnySchema;
timeUUID(): joi.AnySchema;
};
type DynogelsItemCallback = (err: Error, data: Item) => void;
export interface Model {
new(attrs: { [key: string]: any }): Item;
get(hashKey: any, rangeKey: any, options: AWS.DynamoDB.GetItemInput, callback: DynogelsItemCallback): void;
get(haskKey: any, options: AWS.DynamoDB.GetItemInput, callback: DynogelsItemCallback): void;
get(hashKey: any, rangeKey: any, options: GetItemOptions, callback: DynogelsItemCallback): void;
get(haskKey: any, options: GetItemOptions, callback: DynogelsItemCallback): void;
get(hashKey: any, callback: DynogelsItemCallback): void;
get(hashKey: any, rangeKey: any, callback: DynogelsItemCallback): void;
create(item: any, options: AWS.DynamoDB.CreateTableInput, callback: DynogelsItemCallback): void;
create(item: any, options: CreateItemOptions, callback: DynogelsItemCallback): void;
create(item: any, callback: DynogelsItemCallback): void;
update(item: any, options: AWS.DynamoDB.UpdateItemInput, callback: DynogelsItemCallback): void;
update(item: any, options: UpdateItemOptions, callback: DynogelsItemCallback): void;
update(item: any, callback: DynogelsItemCallback): void;
destroy(hashKey: any, rangeKey: any, options: AWS.DynamoDB.DeleteItemInput, callback: DynogelsItemCallback): void;
destroy(haskKey: any, options: AWS.DynamoDB.DeleteItemInput, callback: DynogelsItemCallback): void;
@@ -35,19 +65,74 @@ export interface Model {
destroy(item: any, options: AWS.DynamoDB.DeleteItemInput, callback: DynogelsItemCallback): void;
destroy(item: any, callback: DynogelsItemCallback): void;
query(hashKey: any): Query;
scan(): void;
parallelScan(): void;
getItems(): void;
scan(): Scan;
parallelScan(totalSegments: number): Scan;
getItems(items: string[] | { [key: string]: string }[], callback: (err: Error, items: any[]) => void): void;
getItems(items: string[] | { [key: string]: string }[], options: GetItemOptions, callback: (err: Error, items: any[]) => void): void;
batchGetItems(): void;
createTable(): void;
updateTable(): void;
describeTable(): void;
deleteTable(): void;
deleteTable(callback: (err: Error) => void): void;
tableName(): void;
after(): void;
before(): void;
config(): void;
config(config: ModelConfig): void;
}
interface CreateItemOptions {
expected?: { [key: string]: any };
overwrite?: boolean;
Expected?: AWS.DynamoDB.ExpectedAttributeMap;
ReturnValues?: AWS.DynamoDB.ReturnValue;
ReturnConsumedCapacity?: AWS.DynamoDB.ReturnConsumedCapacity;
ReturnItemCollectionMetrics?: AWS.DynamoDB.ReturnItemCollectionMetrics;
ConditionalOperator?: AWS.DynamoDB.ConditionalOperator;
ConditionExpression?: AWS.DynamoDB.ConditionExpression;
ExpressionAttributeNames?: AWS.DynamoDB.ExpressionAttributeNameMap;
ExpressionAttributeValues?: { [key: string]: any };
}
interface UpdateItemOptions {
expected?: { [key: string]: any };
AttributeUpdates?: AWS.DynamoDB.AttributeUpdates;
Expected?: AWS.DynamoDB.ExpectedAttributeMap;
ConditionalOperator?: AWS.DynamoDB.ConditionalOperator;
ReturnValues?: AWS.DynamoDB.ReturnValue;
ReturnConsumedCapacity?: AWS.DynamoDB.ReturnConsumedCapacity;
ReturnItemCollectionMetrics?: AWS.DynamoDB.ReturnItemCollectionMetrics;
UpdateExpression?: AWS.DynamoDB.UpdateExpression;
ConditionExpression?: AWS.DynamoDB.ConditionExpression;
ExpressionAttributeNames?: AWS.DynamoDB.ExpressionAttributeNameMap;
ExpressionAttributeValues?: { [key: string]: any };
}
interface DestroyItemOptions {
Expected?: AWS.DynamoDB.ExpectedAttributeMap;
ConditionalOperator?: AWS.DynamoDB.ConditionalOperator;
ReturnValues?: AWS.DynamoDB.ReturnValue;
ReturnConsumedCapacity?: AWS.DynamoDB.ReturnConsumedCapacity;
ReturnItemCollectionMetrics?: AWS.DynamoDB.ReturnItemCollectionMetrics;
ConditionExpression?: AWS.DynamoDB.ConditionExpression;
ExpressionAttributeNames?: AWS.DynamoDB.ExpressionAttributeNameMap;
ExpressionAttributeValues?: { [key: string]: any };
}
interface GetItemOptions {
AttributesToGet?: AWS.DynamoDB.AttributeNameList;
ConsistentRead?: AWS.DynamoDB.ConsistentRead;
ReturnConsumedCapacity?: AWS.DynamoDB.ReturnConsumedCapacity;
ProjectionExpression?: AWS.DynamoDB.ProjectionExpression;
ExpressionAttributeNames?: AWS.DynamoDB.ExpressionAttributeNameMap;
}
interface ModelConfig {
tableName?: string;
docClient?: any;
dynamodb?: AWS.DynamoDB;
}
export interface Item {
@@ -86,6 +171,8 @@ export interface Query {
lt(value: any): Query;
gte(value: any): Query;
gt(value: any): Query;
null(): Query;
exists(): Query;
beginsWith(value: any): Query;
between(value1: any, value2: any): Query;
};
@@ -106,15 +193,16 @@ export interface Query {
between(value1: any, value2: any): Query;
};
exec(): stream.Readable;
exec(callback: () => void): void;
exec(callback: (err: Error, data: any) => void): void;
}
export interface Scan {
limit(number: number): Scan;
addFilterCondition(condition: any): Scan;
startKey(hashKey: any, rangeKey: any): Scan;
startKey(hashKey: any, rangeKey?: any): Scan;
attributes(attrs: any): Scan;
select(value: any): Scan;
returnConsumedCapacity(): Scan;
segments(segment: any, totalSegments: number): Scan;
where(keyName: string): {
equals(value: any): Scan;
@@ -131,26 +219,32 @@ export interface Scan {
in(values: any[]): Scan;
beginsWith(value: any): Scan;
between(value1: any, value2: any): Scan;
notNull(): Scan;
};
filterExpression(expression: any): Scan;
expressionAttributeNames(data: any): Scan;
expressionAttributeValues(data: any): Scan;
projectionExpression(data: any): Scan;
exec(): stream.Readable;
exec(callback: () => void): void;
exec(callback: (err: Error, data: any) => void): void;
loadAll(): Scan;
}
type tableResolve = () => string;
type schemaType = { [key: string]: joi.AnySchema | schemaType };
export interface ModelConfiguration {
hashKey: string,
rangeKey?: string,
timestamps?: boolean,
createdAt?: boolean,
updatedAtField?: string,
schema: { [key: string]: any },
updatedAt?: string,
schema?: schemaType,
validation?: joi.ValidationOptions,
tableName?: string | tableResolve;
indexes?: any[];
log?: Log;
}
interface Document {
[key: string]: any;