simple-dynamo-ts 1.0.2

package/README.md

@@ -0,0 +1,454 @@
+# simple-dynamo-ts
+
+A simple, type-safe TypeScript library for working with AWS DynamoDB using decorators and a repository pattern. This library provides a clean and intuitive API for DynamoDB operations while maintaining type safety and leveraging TypeScript decorators for entity configuration.
+
+## Features
+
+- 🎯 **Type-Safe**: Full TypeScript support with type inference
+- 🏗️ **Decorator-Based**: Use decorators to define DynamoDB entities and keys
+- 📦 **Repository Pattern**: Extend `DynamoDBRepository` for clean, reusable data access
+- 🔍 **Query Support**: Built-in support for queries, indexes, and sort key comparisons
+- 🛡️ **Error Handling**: Custom error classes for better error handling
+- ⚡ **Lightweight**: Minimal dependencies, only requires `@aws-sdk/lib-dynamodb` and `reflect-metadata`
+
+## Installation
+
+```bash
+npm install simple-dynamo-ts
+# or
+pnpm add simple-dynamo-ts
+# or
+yarn add simple-dynamo-ts
+```
+
+### Peer Dependencies
+
+This library requires `@aws-sdk/lib-dynamodb` as a peer dependency:
+
+```bash
+npm install @aws-sdk/lib-dynamodb
+```
+
+## Prerequisites
+
+- TypeScript 5.7+
+- Node.js 18+
+- Enable `experimentalDecorators` and `emitDecoratorMetadata` in your `tsconfig.json`
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+## Quick Start
+
+### 1. Define Your Entity
+
+Create a class representing your DynamoDB table item and decorate it:
+
+```typescript
+import { DynamoTable, PartitionKey, SortKey, IndexSortKey } from "simple-dynamo-ts";
+
+@DynamoTable("User")
+export class UserEntity {
+  @PartitionKey()
+  orgId!: string;
+
+  @SortKey()
+  id: string = "generate-id";
+
+  @IndexSortKey("EmailIndex")
+  email!: string;
+
+  password!: string;
+  role: string = "USER";
+  createdAt!: string;
+  updatedAt!: string;
+  deletedAt?: string;
+}
+```
+
+### 2. Create a Repository
+
+Extend `DynamoDBRepository` to create your repository:
+
+```typescript
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { DynamoDBRepository, QueryOptions } from "simple-dynamo-ts";
+import { UserEntity } from "./user.entity";
+
+export class UsersRepository extends DynamoDBRepository<UserEntity> {
+  constructor(protected readonly client: DynamoDBDocumentClient) {
+    super(client, UserEntity);
+  }
+
+  async findAll(): Promise<UserEntity[]> {
+    const response = await this.query({ pk: "USER" });
+    return response.items;
+  }
+
+  async getById(id: string): Promise<UserEntity> {
+    return await this.getItem("USER", id);
+  }
+
+  async findByEmail(email: string): Promise<UserEntity> {
+    const queryOptions: QueryOptions = {
+      pk: "USER",
+      sk: email,
+      indexName: "EmailIndex",
+    };
+    const response = await this.query(queryOptions);
+
+    if (response.count) return response.items[0];
+    throw new Error("User with this email not found!");
+  }
+}
+```
+
+### 3. Use Your Repository
+
+```typescript
+import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { UsersRepository } from "./users.repository";
+
+// Initialize DynamoDB client
+const client = new DynamoDBClient({ region: "us-east-1" });
+const docClient = DynamoDBDocumentClient.from(client);
+
+// Create repository instance
+const usersRepository = new UsersRepository(docClient);
+
+// Use repository methods
+const user = await usersRepository.getById("user-123");
+const allUsers = await usersRepository.findAll();
+const userByEmail = await usersRepository.findByEmail("user@example.com");
+```
+
+## Decorators
+
+### `@DynamoTable(tableName?)`
+
+Marks a class as a DynamoDB table entity. The table name is optional - if not provided, the class name will be used.
+
+```typescript
+@DynamoTable("User")  // Explicit table name
+export class UserEntity { }
+
+@DynamoTable()  // Uses class name "UserEntity" as table name
+export class UserEntity { }
+```
+
+### `@PartitionKey(fieldName?)`
+
+Marks a property as the partition key (HASH key). The field name is optional - if not provided, the property name will be used.
+
+```typescript
+@PartitionKey()  // Uses property name "orgId"
+orgId!: string;
+
+@PartitionKey("organizationId")  // Uses "organizationId" as DynamoDB field name
+orgId!: string;
+```
+
+### `@SortKey(fieldName?)`
+
+Marks a property as the sort key (RANGE key). The field name is optional.
+
+```typescript
+@SortKey()
+id!: string;
+```
+
+### `@IndexPartitionKey(indexName, fieldName?)`
+
+Marks a property as a partition key for a DynamoDB Global Secondary Index (GSI).
+
+```typescript
+@IndexPartitionKey("EmailIndex", "orgId")
+orgId!: string;
+```
+
+### `@IndexSortKey(indexName, fieldName?)`
+
+Marks a property as a sort key for a DynamoDB Global Secondary Index (GSI).
+
+```typescript
+@IndexSortKey("EmailIndex", "email")
+email!: string;
+```
+
+## Repository API
+
+The `DynamoDBRepository<T>` class provides the following methods:
+
+### `create(item: T): Promise<T>`
+
+Creates a new item in DynamoDB. Throws an error if an item with the same key already exists.
+
+```typescript
+const newUser: UserEntity = {
+  orgId: "ORG-123",
+  id: "user-456",
+  email: "user@example.com",
+  password: "hashed-password",
+  role: "USER",
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString(),
+};
+
+const created = await usersRepository.create(newUser);
+```
+
+### `getItem(pk: DynamoKey, sk?: DynamoKey): Promise<T>`
+
+Retrieves a single item by its partition key and optional sort key. Throws `ItemNotFoundError` if the item doesn't exist.
+
+```typescript
+// With partition key only
+const item = await repository.getItem("PK-VALUE");
+
+// With partition and sort key
+const item = await repository.getItem("PK-VALUE", "SK-VALUE");
+```
+
+### `put(item: T): Promise<T>`
+
+Puts an item into DynamoDB (creates or updates). Unlike `create`, this will overwrite existing items.
+
+```typescript
+const updated = await usersRepository.put(userEntity);
+```
+
+### `query(options: QueryOptions): Promise<{ items: T[]; lastEvaluatedKey: T; count: number }>`
+
+Queries DynamoDB items. Supports partition key queries, sort key comparisons, and index queries.
+
+```typescript
+// Simple partition key query
+const result = await repository.query({ pk: "USER" });
+
+// Query with sort key
+const result = await repository.query({
+  pk: "USER",
+  sk: "user-123",
+});
+
+// Query with sort key comparison
+const result = await repository.query({
+  pk: "USER",
+  sk: "user-",
+  skComparator: "begins_with",
+});
+
+// Query using an index
+const result = await repository.query({
+  pk: "ORG-123",
+  sk: "user@example.com",
+  indexName: "EmailIndex",
+});
+
+// Query with limit and sort order
+const result = await repository.query({
+  pk: "USER",
+  limit: 10,
+  scanIndexForward: false, // Sort descending
+});
+```
+
+#### QueryOptions
+
+```typescript
+type QueryOptions = {
+  pk: DynamoKey;                    // Partition key value (required)
+  sk?: DynamoKey;                   // Sort key value (optional)
+  skComparator?: "=" | ">" | "<" | ">=" | "<=" | "BETWEEN" | "begins_with";
+  indexName?: string;               // Index name for GSI or LSI queries
+  scanIndexForward?: boolean;        // Sort order (default: true)
+  limit?: number;                   // Maximum number of items to return
+};
+```
+
+### `softDelete(pk: DynamoKey, sk?: DynamoKey): Promise<void>`
+
+Performs a soft delete by setting the `deletedAt` field to the current timestamp.
+
+```typescript
+await usersRepository.softDelete("USER", "user-123");
+```
+
+### `remove(pk: DynamoKey, sk?: DynamoKey): Promise<void>`
+
+Permanently deletes an item from DynamoDB.
+
+```typescript
+await usersRepository.remove("USER", "user-123");
+```
+
+## Error Handling
+
+The library provides custom error classes for better error handling:
+
+### `ItemNotFoundError`
+
+Thrown when attempting to get an item that doesn't exist.
+
+```typescript
+import { ItemNotFoundError } from "simple-dynamo-ts";
+
+try {
+  const user = await repository.getItem("PK", "SK");
+} catch (error) {
+  if (error instanceof ItemNotFoundError) {
+    console.log("Item not found");
+  }
+}
+```
+
+### `InvalidParametersError`
+
+Thrown when invalid parameters are passed to repository methods.
+
+### `DecoratorMissingError`
+
+Thrown when required decorators are missing from entity classes.
+
+### `DuplicateDecoratorError`
+
+Thrown when duplicate decorators are applied (e.g., multiple `@PartitionKey` decorators).
+
+## Complete Example
+
+Here's a complete example demonstrating entity definition and repository usage:
+
+```typescript
+// user.entity.ts
+import { DynamoTable, PartitionKey, SortKey, IndexSortKey } from "simple-dynamo-ts";
+
+@DynamoTable("User")
+export class UserEntity {
+  @PartitionKey()
+  orgId!: string;
+
+  @SortKey()
+  id: string = "generate-id";
+
+  @IndexSortKey("EmailIndex")
+  email!: string;
+
+  password!: string;
+  role: string = "USER";
+  createdAt!: string;
+  updatedAt!: string;
+  deletedAt?: string;
+}
+
+// users.repository.ts
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { DynamoDBRepository, QueryOptions } from "simple-dynamo-ts";
+import { UserEntity } from "./user.entity";
+
+export class UsersRepository extends DynamoDBRepository<UserEntity> {
+  constructor(protected readonly client: DynamoDBDocumentClient) {
+    super(client, UserEntity);
+  }
+
+  async findAll(): Promise<UserEntity[]> {
+    const response = await this.query({ pk: "USER" });
+    return response.items;
+  }
+
+  async getById(id: string): Promise<UserEntity> {
+    return await this.getItem("USER", id);
+  }
+
+  async delete(id: string): Promise<void> {
+    return await this.softDelete("USER", id);
+  }
+
+  async findByEmail(email: string): Promise<UserEntity> {
+    const queryOptions: QueryOptions = {
+      pk: "USER",
+      sk: email,
+      indexName: "EmailIndex",
+    };
+    const response = await this.query(queryOptions);
+
+    if (response.count) return response.items[0];
+    throw new Error("User with this email not found!");
+  }
+}
+
+// app.ts
+import { DynamoDBClient } from "@aws-sdk/client-dynamodb";
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { UsersRepository } from "./users.repository";
+
+const client = new DynamoDBClient({ region: "us-east-1" });
+const docClient = DynamoDBDocumentClient.from(client);
+const usersRepository = new UsersRepository(docClient);
+
+// Create a user
+const newUser: UserEntity = {
+  orgId: "ORG-123",
+  id: "user-456",
+  email: "user@example.com",
+  password: "hashed-password",
+  role: "USER",
+  createdAt: new Date().toISOString(),
+  updatedAt: new Date().toISOString(),
+};
+await usersRepository.create(newUser);
+
+// Get user by ID
+const user = await usersRepository.getById("user-456");
+
+// Find user by email
+const userByEmail = await usersRepository.findByEmail("user@example.com");
+
+// Get all users
+const allUsers = await usersRepository.findAll();
+
+// Soft delete
+await usersRepository.delete("user-456");
+```
+
+## Type Definitions
+
+### `DynamoKey`
+
+```typescript
+type DynamoKey = string | number;
+```
+
+### `DynamoKeyMap`
+
+```typescript
+type DynamoKeyMap = Record<string, DynamoKey>;
+```
+
+### `QueryOptions`
+
+See the [Query API](#queryoptions) section above.
+
+## Helper Functions
+
+The library also exports helper functions for retrieving metadata from decorated classes:
+
+- `getDynamoTableName(target)`: Get the table name from a decorated class
+- `getPartitionKeyName(target)`: Get the partition key field name
+- `getSortKeyName(target)`: Get the sort key field name
+- `getIndexPartitionKeyName(target, indexName)`: Get the partition key for an index
+- `getIndexSortKeyName(target, indexName)`: Get the sort key for an index
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT © Blimit

package/dist/decorators.d.ts

@@ -0,0 +1,18 @@
+import "reflect-metadata";
+import { DynamoEntityTarget } from "./types";
+export declare const DYNAMO_TABLE_NAME_KEY = "dynamo:table:name";
+export declare const DYNAMO_PARTITION_KEY_KEY = "dynamo:partition:key";
+export declare const DYNAMO_SORT_KEY_KEY = "dynamo:sort:key";
+export declare const DYNAMO_INDEX_PARTITION_KEYS_KEY = "dynamo:index:partition:keys";
+export declare const DYNAMO_INDEX_SORT_KEYS_KEY = "dynamo:index:sort:keys";
+export declare function DynamoTable(tableName?: string): ClassDecorator;
+export declare function PartitionKey(fieldName?: string): PropertyDecorator;
+export declare function SortKey(fieldName?: string): PropertyDecorator;
+export declare function IndexPartitionKey(indexName: string, fieldName?: string): PropertyDecorator;
+export declare function IndexSortKey(indexName: string, fieldName?: string): PropertyDecorator;
+export declare function getDynamoTableName(target: DynamoEntityTarget): string | undefined;
+export declare function getPartitionKeyName(target: DynamoEntityTarget): string | undefined;
+export declare function getSortKeyName(target: DynamoEntityTarget): string | undefined;
+export declare function getIndexPartitionKeyName(target: DynamoEntityTarget, indexName: string): string | undefined;
+export declare function getIndexSortKeyName(target: DynamoEntityTarget, indexName: string): string | undefined;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AACzD,eAAO,MAAM,wBAAwB,yBAAyB,CAAC;AAC/D,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AACrD,eAAO,MAAM,+BAA+B,gCAAgC,CAAC;AAC7E,eAAO,MAAM,0BAA0B,2BAA2B,CAAC;AAiEnE,wBAAgB,WAAW,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,cAAc,CAc9D;AAqBD,wBAAgB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAelE;AAuBD,wBAAgB,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,iBAAiB,CAe7D;AA2BD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,CAyBnB;AA2BD,wBAAgB,YAAY,CAC1B,SAAS,EAAE,MAAM,EACjB,SAAS,CAAC,EAAE,MAAM,GACjB,iBAAiB,CAqBnB;AAeD,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,kBAAkB,GACzB,MAAM,GAAG,SAAS,CAKpB;AAeD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,GACzB,MAAM,GAAG,SAAS,CAKpB;AAeD,wBAAgB,cAAc,CAAC,MAAM,EAAE,kBAAkB,GAAG,MAAM,GAAG,SAAS,CAK7E;AAgBD,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAUpB;AAgBD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,kBAAkB,EAC1B,SAAS,EAAE,MAAM,GAChB,MAAM,GAAG,SAAS,CAUpB"}

package/dist/decorators.js

@@ -0,0 +1,116 @@
+import "reflect-metadata";
+import { DuplicateDecoratorError } from "./exceptions";
+export const DYNAMO_TABLE_NAME_KEY = "dynamo:table:name";
+export const DYNAMO_PARTITION_KEY_KEY = "dynamo:partition:key";
+export const DYNAMO_SORT_KEY_KEY = "dynamo:sort:key";
+export const DYNAMO_INDEX_PARTITION_KEYS_KEY = "dynamo:index:partition:keys";
+export const DYNAMO_INDEX_SORT_KEYS_KEY = "dynamo:index:sort:keys";
+function getConstructor(target) {
+    return typeof target === "function" ? target : target.constructor;
+}
+function getPrototype(target) {
+    return getConstructor(target).prototype;
+}
+function validateDuplicateDecorator(target, key, decoratorName, conflict) {
+    const existingKey = Reflect.getMetadata(key, target);
+    if (existingKey !== undefined) {
+        throw new DuplicateDecoratorError(`Multiple ${decoratorName} decorators found in class "${target.constructor?.name || "Unknown"}". ` +
+            `Existing decorator: "${existingKey}", conflicting property: "${String(conflict)}"`);
+    }
+}
+function validateNonEmptyString(value, paramName) {
+    if (value.trim() === "") {
+        throw new Error(`Invalid ${paramName}: cannot be an empty string.`);
+    }
+}
+export function DynamoTable(tableName) {
+    return function (target) {
+        if (tableName) {
+            validateNonEmptyString(tableName, "tableName");
+        }
+        const dynamoTableName = tableName ?? target.name;
+        validateDuplicateDecorator(target, DYNAMO_TABLE_NAME_KEY, "@DynamoTable", dynamoTableName);
+        Reflect.defineMetadata(DYNAMO_TABLE_NAME_KEY, dynamoTableName, target);
+    };
+}
+export function PartitionKey(fieldName) {
+    return function (target, propertyKey) {
+        if (fieldName) {
+            validateNonEmptyString(fieldName, "fieldName");
+        }
+        const dynamoFieldName = fieldName ?? String(propertyKey);
+        validateDuplicateDecorator(target, DYNAMO_PARTITION_KEY_KEY, "@PartitionKey", dynamoFieldName);
+        Reflect.defineMetadata(DYNAMO_PARTITION_KEY_KEY, dynamoFieldName, target);
+    };
+}
+export function SortKey(fieldName) {
+    return function (target, propertyKey) {
+        if (fieldName) {
+            validateNonEmptyString(fieldName, "fieldName");
+        }
+        const dynamoFieldName = fieldName ?? String(propertyKey);
+        validateDuplicateDecorator(target, DYNAMO_SORT_KEY_KEY, "@SortKey", propertyKey);
+        Reflect.defineMetadata(DYNAMO_SORT_KEY_KEY, dynamoFieldName, target);
+    };
+}
+export function IndexPartitionKey(indexName, fieldName) {
+    return function (target, propertyKey) {
+        validateNonEmptyString(indexName, "indexName");
+        if (fieldName) {
+            validateNonEmptyString(fieldName, "fieldName");
+        }
+        const dynamoFieldName = fieldName ?? String(propertyKey);
+        const existingKeys = Reflect.getMetadata(DYNAMO_INDEX_PARTITION_KEYS_KEY, target) ?? {};
+        if (existingKeys[indexName] !== undefined) {
+            throw new DuplicateDecoratorError(`Multiple @IndexPartitionKey decorators found for index "${indexName}" in class "${target.constructor?.name || "Unknown"}". ` +
+                `Existing partition key: "${existingKeys[indexName]}", conflicting property: "${String(propertyKey)}"`);
+        }
+        existingKeys[indexName] = dynamoFieldName;
+        Reflect.defineMetadata(DYNAMO_INDEX_PARTITION_KEYS_KEY, existingKeys, target);
+    };
+}
+export function IndexSortKey(indexName, fieldName) {
+    return function (target, propertyKey) {
+        validateNonEmptyString(indexName, "indexName");
+        if (fieldName) {
+            validateNonEmptyString(fieldName, "fieldName");
+        }
+        const dynamoFieldName = fieldName ?? String(propertyKey);
+        const existingKeys = Reflect.getMetadata(DYNAMO_INDEX_SORT_KEYS_KEY, target) ?? {};
+        if (existingKeys[indexName] !== undefined) {
+            throw new DuplicateDecoratorError(`Multiple @IndexSortKey decorators found for index "${indexName}" in class "${target.constructor?.name || "Unknown"}". ` +
+                `Existing sort key: "${existingKeys[indexName]}", conflicting property: "${String(propertyKey)}"`);
+        }
+        existingKeys[indexName] = dynamoFieldName;
+        Reflect.defineMetadata(DYNAMO_INDEX_SORT_KEYS_KEY, existingKeys, target);
+    };
+}
+export function getDynamoTableName(target) {
+    const constructor = getConstructor(target);
+    return Reflect.getMetadata(DYNAMO_TABLE_NAME_KEY, constructor);
+}
+export function getPartitionKeyName(target) {
+    const prototype = getPrototype(target);
+    return Reflect.getMetadata(DYNAMO_PARTITION_KEY_KEY, prototype);
+}
+export function getSortKeyName(target) {
+    const prototype = getPrototype(target);
+    return Reflect.getMetadata(DYNAMO_SORT_KEY_KEY, prototype);
+}
+export function getIndexPartitionKeyName(target, indexName) {
+    if (!indexName || indexName.trim() === "") {
+        throw new Error("indexName cannot be empty");
+    }
+    const prototype = getPrototype(target);
+    const indexKeys = Reflect.getMetadata(DYNAMO_INDEX_PARTITION_KEYS_KEY, prototype);
+    return indexKeys?.[indexName];
+}
+export function getIndexSortKeyName(target, indexName) {
+    if (!indexName || indexName.trim() === "") {
+        throw new Error("indexName cannot be empty");
+    }
+    const prototype = getPrototype(target);
+    const indexKeys = Reflect.getMetadata(DYNAMO_INDEX_SORT_KEYS_KEY, prototype);
+    return indexKeys?.[indexName];
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../src/decorators.ts"],"names":[],"mappings":"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"}

package/dist/exceptions.d.ts

@@ -0,0 +1,13 @@
+export declare class ItemNotFoundError extends Error {
+    constructor(message: string);
+}
+export declare class InvalidParametersError extends Error {
+    constructor(message: string);
+}
+export declare class DecoratorMissingError extends Error {
+    constructor(message: string);
+}
+export declare class DuplicateDecoratorError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=exceptions.d.ts.map

package/dist/exceptions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.d.ts","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,qBAAa,iBAAkB,SAAQ,KAAK;gBAC9B,OAAO,EAAE,MAAM;CAO5B;AAED,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,OAAO,EAAE,MAAM;CAO5B;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAO5B;AAED,qBAAa,uBAAwB,SAAQ,KAAK;gBACpC,OAAO,EAAE,MAAM;CAO5B"}

package/dist/exceptions.js

@@ -0,0 +1,29 @@
+export class ItemNotFoundError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "ItemNotFoundError";
+        Object.setPrototypeOf(this, ItemNotFoundError.prototype);
+    }
+}
+export class InvalidParametersError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "InvalidParametersError";
+        Object.setPrototypeOf(this, InvalidParametersError.prototype);
+    }
+}
+export class DecoratorMissingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DecoratorMissingError";
+        Object.setPrototypeOf(this, DecoratorMissingError.prototype);
+    }
+}
+export class DuplicateDecoratorError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "DuplicateDecoratorError";
+        Object.setPrototypeOf(this, DuplicateDecoratorError.prototype);
+    }
+}
+//# sourceMappingURL=exceptions.js.map

package/dist/exceptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exceptions.js","sourceRoot":"","sources":["../src/exceptions.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAGhC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC/C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QAGrC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,sBAAsB,CAAC,SAAS,CAAC,CAAC;IAChE,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,KAAK;IAC9C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;QAGpC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;QAGtC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,uBAAuB,CAAC,SAAS,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { DynamoDBRepository } from "./simple-dynamodb-repository";
+export { DynamoTable, PartitionKey, SortKey, IndexPartitionKey, IndexSortKey, getDynamoTableName, getPartitionKeyName, getSortKeyName, getIndexPartitionKeyName, getIndexSortKeyName, } from "./decorators";
+export type { QueryOptions, DynamoKey, DynamoKeyMap } from "./types";
+export { ItemNotFoundError, InvalidParametersError, DecoratorMissingError, DuplicateDecoratorError, } from "./exceptions";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAGtB,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAGrE,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { DynamoDBRepository } from "./simple-dynamodb-repository";
+export { DynamoTable, PartitionKey, SortKey, IndexPartitionKey, IndexSortKey, getDynamoTableName, getPartitionKeyName, getSortKeyName, getIndexPartitionKeyName, getIndexSortKeyName, } from "./decorators";
+export { ItemNotFoundError, InvalidParametersError, DecoratorMissingError, DuplicateDecoratorError, } from "./exceptions";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAGlE,OAAO,EACL,WAAW,EACX,YAAY,EACZ,OAAO,EACP,iBAAiB,EACjB,YAAY,EACZ,kBAAkB,EAClB,mBAAmB,EACnB,cAAc,EACd,wBAAwB,EACxB,mBAAmB,GACpB,MAAM,cAAc,CAAC;AAMtB,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,GACxB,MAAM,cAAc,CAAC"}