orm-dynamodb 1.0.0

package/README.md

@@ -0,0 +1,181 @@
+# orm-dynamodb
+
+Lightweight TypeScript decorators for modeling DynamoDB items as classes.
+
+## Install
+
+```bash
+npm install orm-dynamodb
+```
+
+The package depends on `@aws-sdk/client-dynamodb` and `@aws-sdk/lib-dynamodb`.
+
+Your TypeScript config must enable decorators:
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  }
+}
+```
+
+## Quick Start
+
+```ts
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import {
+  BaseEntity,
+  Entity,
+  FromDbModel,
+  HashKeyValue,
+  Link,
+  SortKeyValue,
+  ToDbModel
+} from 'orm-dynamodb';
+
+BaseEntity.configure(new DynamoDBClient({ region: process.env.AWS_REGION || 'us-east-1' }));
+
+@Entity('content', 'pk', 'sk')
+class Author extends BaseEntity {
+  @HashKeyValue
+  get hashKey() {
+    return 'AUTHOR';
+  }
+
+  @SortKeyValue
+  get sortKey() {
+    return this.authorId;
+  }
+
+  authorId: string;
+  displayName: string;
+
+  constructor(authorId: string = '', displayName: string = '') {
+    super();
+    this.authorId = authorId;
+    this.displayName = displayName;
+  }
+}
+
+@Entity('content', 'pk', 'sk')
+class Post extends BaseEntity {
+  @HashKeyValue
+  get hashKey() {
+    return 'POST';
+  }
+
+  @SortKeyValue
+  get sortKey() {
+    return this.slug;
+  }
+
+  slug: string;
+  title: string;
+  publishedAt: Date | null;
+
+  @Link(Author)
+  author: Author | undefined;
+
+  constructor(slug: string = '', title: string = '', publishedAt: Date | null = null) {
+    super();
+    this.slug = slug;
+    this.title = title;
+    this.publishedAt = publishedAt;
+  }
+
+  @ToDbModel
+  static toDbModel(post: Post) {
+    return {
+      publishedAt: post.publishedAt ? post.publishedAt.toISOString() : null
+    };
+  }
+
+  @FromDbModel
+  static fromDbModel(item: { publishedAt?: string | null }) {
+    return {
+      publishedAt: item.publishedAt ? new Date(item.publishedAt) : null
+    };
+  }
+}
+
+async function run() {
+  const post = new Post('decorators-with-dynamodb', 'Decorators With DynamoDB', new Date());
+  post.author = new Author('ada-lovelace', 'Ada Lovelace');
+
+  await post.save();
+
+  const loaded = await Post.get('decorators-with-dynamodb');
+  await loaded?.loadLinks();
+
+  console.log(loaded?.author?.displayName);
+}
+```
+
+## API
+
+The package exports:
+
+- `BaseEntity`
+- `Entity`
+- `HashKeyValue`
+- `SortKeyValue`
+- `Link`
+- `ToDbModel`
+- `FromDbModel`
+
+Core capabilities:
+
+- explicit DynamoDB client configuration via `BaseEntity.configure(...)` or `@Entity(..., dbClient)`
+- `save()`, `update()`, and `delete()` instance methods
+- `get()`, `query()`, and common query helpers on the entity class
+- linked entity references with `@Link(...)` and `loadLinks()`
+- custom read/write mapping with `@ToDbModel` and `@FromDbModel`
+- automatic `createdAt` and `updatedAt` timestamps
+
+## Local Development
+
+Install dependencies:
+
+```bash
+pnpm install
+```
+
+Build the package:
+
+```bash
+pnpm build
+```
+
+Run the local example:
+
+```bash
+pnpm exec tsx examples.ts
+```
+
+Check what will be published:
+
+```bash
+npm run pack:check
+```
+
+## Publish
+
+Make sure the package name in `package.json` is the one you want to publish and is available on npm, then:
+
+```bash
+npm login
+npm publish
+```
+
+If you rename the package, update the import path in this README to match.
+
+## Notes
+
+- Static lookups assume the hash key can be derived from a default-constructed instance.
+- Query helpers all operate within a single partition key value.
+- Link loading currently issues individual `GetCommand` calls per linked record.
+- This is a lightweight utility, not a schema or migration system.
+
+See [examples.ts](./examples.ts) for a fuller usage example.

package/dist/BaseEntity.d.ts

@@ -0,0 +1,21 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import type { QueryOptions, EntityMetadata } from './types';
+export declare class BaseEntity {
+    protected getMetadata(): EntityMetadata;
+    protected getKey(): any;
+    protected toItem(): any;
+    insert(): Promise<this>;
+    update(attributes: Partial<this>): Promise<this>;
+    delete(): Promise<void>;
+    loadLinks(): Promise<this>;
+    static configure(dynamoDBClient: DynamoDBClient, documentClientConfig?: any): void;
+    static get<T extends BaseEntity>(this: new (...args: any[]) => T, sortKeyValue: any): Promise<T | null>;
+    static query<T extends BaseEntity>(this: new (...args: any[]) => T, options?: QueryOptions): Promise<T[]>;
+    static queryAll<T extends BaseEntity>(this: new (...args: any[]) => T, limit?: number): Promise<T[]>;
+    static queryStartsWith<T extends BaseEntity>(this: new (...args: any[]) => T, sortKeyPrefix: string, limit?: number): Promise<T[]>;
+    static queryBetween<T extends BaseEntity>(this: new (...args: any[]) => T, start: any, end: any, limit?: number): Promise<T[]>;
+    static queryGreaterThan<T extends BaseEntity>(this: new (...args: any[]) => T, sortKeyValue: any, limit?: number): Promise<T[]>;
+    static queryLessThan<T extends BaseEntity>(this: new (...args: any[]) => T, sortKeyValue: any, limit?: number): Promise<T[]>;
+    static queryEquals<T extends BaseEntity>(this: new (...args: any[]) => T, sortKeyValue: any, limit?: number): Promise<T[]>;
+}
+//# sourceMappingURL=BaseEntity.d.ts.map

package/dist/BaseEntity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseEntity.d.ts","sourceRoot":"","sources":["../BaseEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAS1D,OAAO,KAAK,EAAgB,YAAY,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG1E,qBAAa,UAAU;IAEnB,SAAS,CAAC,WAAW,IAAI,cAAc;IAIvC,SAAS,CAAC,MAAM;IAehB,SAAS,CAAC,MAAM;IA4DV,MAAM;IAuIN,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,IAAI,CAAC;IAiChC,MAAM;IAyFN,SAAS;IAmGf,MAAM,CAAC,SAAS,CAAC,cAAc,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAAE,GAAG;WAI9D,GAAG,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;WAmChG,KAAK,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAwFlG,QAAQ,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAI7F,eAAe,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAO3H,YAAY,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAOvH,gBAAgB,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAOxH,aAAa,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;WAOrH,WAAW,CAAC,CAAC,SAAS,UAAU,EAAE,IAAI,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC;CAMnI"}

package/dist/BaseEntity.js

@@ -0,0 +1,533 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseEntity = void 0;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const symbols_1 = require("./symbols");
+const client_1 = require("./client");
+class BaseEntity {
+    getMetadata() {
+        return this.constructor.__entityMetadata__;
+    }
+    getKey() {
+        const metadata = this.getMetadata();
+        const key = {};
+        if (metadata.hashKeyGetter) {
+            key[metadata.hashKeyName] = this[metadata.hashKeyGetter];
+        }
+        if (metadata.sortKeyName && metadata.sortKeyGetter) {
+            key[metadata.sortKeyName] = this[metadata.sortKeyGetter];
+        }
+        return key;
+    }
+    toItem() {
+        const item = { ...this };
+        const metadata = this.getMetadata();
+        const key = this.getKey();
+        // Apply custom toDbModel mapper if defined
+        const toDbModelMapper = this.constructor[symbols_1.TO_DB_MODEL_METADATA];
+        if (toDbModelMapper) {
+            const mappedData = this.constructor[toDbModelMapper](this);
+            Object.assign(item, mappedData);
+        }
+        // Handle linked entities
+        const links = this.constructor.prototype[symbols_1.LINKS_METADATA] || [];
+        for (const link of links) {
+            const value = this[link.propertyKey];
+            const isInline = link.inline ?? false;
+            if (isInline) {
+                if (value !== undefined && value !== null) {
+                    if (link.isArray) {
+                        item[`__${link.propertyKey}ID`] = value.map((linkedItem) => {
+                            const linkedKey = linkedItem.getKey();
+                            const linkedMetadata = linkedItem.getMetadata();
+                            const result = {
+                                [linkedMetadata.hashKeyName]: linkedKey[linkedMetadata.hashKeyName]
+                            };
+                            if (linkedMetadata.sortKeyName) {
+                                result[linkedMetadata.sortKeyName] = linkedKey[linkedMetadata.sortKeyName];
+                            }
+                            return result;
+                        });
+                    }
+                    else {
+                        const linkedItem = value;
+                        const linkedKey = linkedItem.getKey();
+                        const linkedMetadata = linkedItem.getMetadata();
+                        const result = {
+                            [linkedMetadata.hashKeyName]: linkedKey[linkedMetadata.hashKeyName]
+                        };
+                        if (linkedMetadata.sortKeyName) {
+                            result[linkedMetadata.sortKeyName] = linkedKey[linkedMetadata.sortKeyName];
+                        }
+                        item[`__${link.propertyKey}ID`] = result;
+                    }
+                }
+            }
+            else {
+                // Non-inline: ensure no stale __propertyID from a previous loadLinks() is persisted
+                delete item[`__${link.propertyKey}ID`];
+            }
+            // Remove the actual linked entity instances from being saved
+            delete item[link.propertyKey];
+        }
+        return {
+            ...key,
+            ...item
+        };
+    }
+    async insert() {
+        const metadata = this.getMetadata();
+        // Save linked entities first (cascade save)
+        const links = this.constructor.prototype[symbols_1.LINKS_METADATA] || [];
+        for (const link of links) {
+            const value = this[link.propertyKey];
+            if (value !== undefined && value !== null) {
+                if (Array.isArray(value)) {
+                    // Save all linked entities in parallel
+                    await Promise.all(value.map((linkedItem) => linkedItem.insert()));
+                }
+                else {
+                    // Save single linked entity
+                    await value.insert();
+                }
+            }
+        }
+        const item = this.toItem();
+        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.PutCommand({
+            TableName: metadata.tableName,
+            Item: item
+        }));
+        // Write separate link records for non-inline links.
+        // Record shape: { [hashKey]: '__link', [sortKey]: '{parentHK}#{parentSK}#{property}#{linkedHK}#{linkedSK}',
+        //                 linkedHashKey, linkedSortKey, isArray }
+        // Requires the parent entity table to have a sort key.
+        const nonInlineLinks = links.filter(link => {
+            const isInline = link.inline ?? false;
+            return !isInline;
+        });
+        if (nonInlineLinks.length > 0 && !metadata.sortKeyName) {
+            throw new Error(`Entity "${metadata.tableName}" has non-inline @Link properties ` +
+                `(${nonInlineLinks.map(l => l.propertyKey).join(', ')}) but no sort key. ` +
+                `Non-inline links require a sort key. Use @Link(..., { inline: true }) or add a sort key.`);
+        }
+        if (metadata.sortKeyName && nonInlineLinks.length > 0) {
+            const parentKey = this.getKey();
+            const parentHKVal = String(parentKey[metadata.hashKeyName]);
+            const parentSKVal = String(parentKey[metadata.sortKeyName]);
+            for (const link of nonInlineLinks) {
+                const value = this[link.propertyKey];
+                // Delete all existing link records for this property before writing new ones.
+                // Runs even when value is null/undefined so clearing a link removes stale records.
+                const skPrefix = `${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}#`;
+                const existingItems = await (0, client_1.paginatedQuery)({
+                    TableName: metadata.tableName,
+                    KeyConditionExpression: '#pk = :pkval AND begins_with(#sk, :skprefix)',
+                    ExpressionAttributeNames: {
+                        '#pk': metadata.hashKeyName,
+                        '#sk': metadata.sortKeyName
+                    },
+                    ExpressionAttributeValues: {
+                        ':pkval': '__link',
+                        ':skprefix': skPrefix
+                    }
+                });
+                if (existingItems.length > 0) {
+                    const linkedEntityMetadata = link.entityClass.__entityMetadata__;
+                    await Promise.all(existingItems.map(async (rec) => {
+                        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                            TableName: metadata.tableName,
+                            Key: {
+                                [metadata.hashKeyName]: rec[metadata.hashKeyName],
+                                [metadata.sortKeyName]: rec[metadata.sortKeyName]
+                            }
+                        }));
+                        // Delete corresponding back-reference from child's table
+                        if (linkedEntityMetadata.sortKeyName) {
+                            await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                                TableName: linkedEntityMetadata.tableName,
+                                Key: {
+                                    [linkedEntityMetadata.hashKeyName]: '__backlink',
+                                    [linkedEntityMetadata.sortKeyName]: `${(0, client_1.encodeLinkSegment)(rec.linkedHashKey)}#${(0, client_1.encodeLinkSegment)(rec.linkedSortKey)}#${(0, client_1.encodeLinkSegment)(metadata.tableName)}#${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}`
+                                }
+                            }));
+                        }
+                    }));
+                }
+                if (value == null)
+                    continue;
+                const linkedItems = link.isArray ? value : [value];
+                await Promise.all(linkedItems.map(async (linkedItem) => {
+                    const linkedKey = linkedItem.getKey();
+                    const linkedMeta = linkedItem.getMetadata();
+                    const linkedHKVal = String(linkedKey[linkedMeta.hashKeyName]);
+                    const linkedSKVal = linkedMeta.sortKeyName
+                        ? String(linkedKey[linkedMeta.sortKeyName])
+                        : '';
+                    const linkRecord = {
+                        [metadata.hashKeyName]: '__link',
+                        [metadata.sortKeyName]: `${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}#${(0, client_1.encodeLinkSegment)(linkedHKVal)}#${(0, client_1.encodeLinkSegment)(linkedSKVal)}`,
+                        linkedHashKey: linkedHKVal,
+                        linkedSortKey: linkedSKVal,
+                        isArray: link.isArray
+                    };
+                    await (0, client_1.getDocClient)().send(new lib_dynamodb_1.PutCommand({
+                        TableName: metadata.tableName,
+                        Item: linkRecord
+                    }));
+                    // Write back-reference in child's table so child deletions can clean up this forward link.
+                    if (linkedMeta.sortKeyName) {
+                        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.PutCommand({
+                            TableName: linkedMeta.tableName,
+                            Item: {
+                                [linkedMeta.hashKeyName]: '__backlink',
+                                [linkedMeta.sortKeyName]: `${(0, client_1.encodeLinkSegment)(linkedHKVal)}#${(0, client_1.encodeLinkSegment)(linkedSKVal)}#${(0, client_1.encodeLinkSegment)(metadata.tableName)}#${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}`,
+                                parentTableName: metadata.tableName,
+                                parentHashKeyName: metadata.hashKeyName,
+                                parentSortKeyName: metadata.sortKeyName,
+                                parentHashKey: parentHKVal,
+                                parentSortKey: parentSKVal,
+                                propertyKey: link.propertyKey
+                            }
+                        }));
+                    }
+                }));
+            }
+        }
+        return this;
+    }
+    async update(attributes) {
+        const metadata = this.getMetadata();
+        const key = this.getKey();
+        const updateExpressions = [];
+        const expressionAttributeNames = {};
+        const expressionAttributeValues = {};
+        let index = 0;
+        for (const [attrName, attrValue] of Object.entries(attributes)) {
+            updateExpressions.push(`#attr${index} = :val${index}`);
+            expressionAttributeNames[`#attr${index}`] = attrName;
+            expressionAttributeValues[`:val${index}`] = attrValue;
+            index++;
+        }
+        updateExpressions.push(`#updatedAt = :updatedAt`);
+        expressionAttributeNames['#updatedAt'] = 'updatedAt';
+        expressionAttributeValues[':updatedAt'] = new Date().toISOString();
+        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.UpdateCommand({
+            TableName: metadata.tableName,
+            Key: key,
+            UpdateExpression: `SET ${updateExpressions.join(', ')}`,
+            ExpressionAttributeNames: expressionAttributeNames,
+            ExpressionAttributeValues: expressionAttributeValues
+        }));
+        Object.assign(this, attributes);
+        return this;
+    }
+    async delete() {
+        const metadata = this.getMetadata();
+        const key = this.getKey();
+        // Clean up non-inline link records before deleting the parent to prevent orphans.
+        if (metadata.sortKeyName) {
+            const links = this.constructor.prototype[symbols_1.LINKS_METADATA] || [];
+            const parentHKVal = String(key[metadata.hashKeyName]);
+            const parentSKVal = String(key[metadata.sortKeyName]);
+            for (const link of links) {
+                const isInline = link.inline ?? false;
+                if (isInline)
+                    continue;
+                const existingItems = await (0, client_1.paginatedQuery)({
+                    TableName: metadata.tableName,
+                    KeyConditionExpression: '#pk = :pkval AND begins_with(#sk, :skprefix)',
+                    ExpressionAttributeNames: { '#pk': metadata.hashKeyName, '#sk': metadata.sortKeyName },
+                    ExpressionAttributeValues: {
+                        ':pkval': '__link',
+                        ':skprefix': `${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}#`
+                    }
+                });
+                const linkedEntityMetadata = link.entityClass.__entityMetadata__;
+                await Promise.all(existingItems.map(async (rec) => {
+                    await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                        TableName: metadata.tableName,
+                        Key: {
+                            [metadata.hashKeyName]: rec[metadata.hashKeyName],
+                            [metadata.sortKeyName]: rec[metadata.sortKeyName]
+                        }
+                    }));
+                    // Delete corresponding back-reference from child's table
+                    if (linkedEntityMetadata.sortKeyName) {
+                        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                            TableName: linkedEntityMetadata.tableName,
+                            Key: {
+                                [linkedEntityMetadata.hashKeyName]: '__backlink',
+                                [linkedEntityMetadata.sortKeyName]: `${(0, client_1.encodeLinkSegment)(rec.linkedHashKey)}#${(0, client_1.encodeLinkSegment)(rec.linkedSortKey)}#${(0, client_1.encodeLinkSegment)(metadata.tableName)}#${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}`
+                            }
+                        }));
+                    }
+                }));
+            }
+        }
+        // Clean up forward link records pointing TO this item (child-side cleanup via back-references).
+        if (metadata.sortKeyName) {
+            const itemHKVal = String(key[metadata.hashKeyName]);
+            const itemSKVal = String(key[metadata.sortKeyName]);
+            const backlinkPrefix = `${(0, client_1.encodeLinkSegment)(itemHKVal)}#${(0, client_1.encodeLinkSegment)(itemSKVal)}#`;
+            const backlinks = await (0, client_1.paginatedQuery)({
+                TableName: metadata.tableName,
+                KeyConditionExpression: '#pk = :pkval AND begins_with(#sk, :skprefix)',
+                ExpressionAttributeNames: { '#pk': metadata.hashKeyName, '#sk': metadata.sortKeyName },
+                ExpressionAttributeValues: {
+                    ':pkval': '__backlink',
+                    ':skprefix': backlinkPrefix
+                }
+            });
+            await Promise.all(backlinks.map(async (backlink) => {
+                // Delete the forward link record in the parent's table
+                const fwdSKVal = `${(0, client_1.encodeLinkSegment)(backlink.parentHashKey)}#${(0, client_1.encodeLinkSegment)(backlink.parentSortKey)}#${(0, client_1.encodeLinkSegment)(backlink.propertyKey)}#${(0, client_1.encodeLinkSegment)(itemHKVal)}#${(0, client_1.encodeLinkSegment)(itemSKVal)}`;
+                await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                    TableName: backlink.parentTableName,
+                    Key: {
+                        [backlink.parentHashKeyName]: '__link',
+                        [backlink.parentSortKeyName]: fwdSKVal
+                    }
+                }));
+                // Delete the back-reference record itself
+                await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+                    TableName: metadata.tableName,
+                    Key: {
+                        [metadata.hashKeyName]: backlink[metadata.hashKeyName],
+                        [metadata.sortKeyName]: backlink[metadata.sortKeyName]
+                    }
+                }));
+            }));
+        }
+        await (0, client_1.getDocClient)().send(new lib_dynamodb_1.DeleteCommand({
+            TableName: metadata.tableName,
+            Key: key
+        }));
+    }
+    async loadLinks() {
+        const parentMetadata = this.getMetadata();
+        const parentKey = this.getKey();
+        const links = this.constructor.prototype[symbols_1.LINKS_METADATA] || [];
+        for (const link of links) {
+            if (!link.entityClass)
+                continue;
+            const EntityClass = link.entityClass;
+            const entityMetadata = EntityClass.__entityMetadata__;
+            const fromDbModelMapper = EntityClass[symbols_1.FROM_DB_MODEL_METADATA];
+            const instantiate = (raw) => {
+                let itemData = raw;
+                if (fromDbModelMapper) {
+                    itemData = { ...raw, ...EntityClass[fromDbModelMapper](raw) };
+                }
+                const instance = new EntityClass();
+                Object.assign(instance, itemData);
+                return instance;
+            };
+            const idField = `__${link.propertyKey}ID`;
+            const idValue = this[idField];
+            if (idValue != null) {
+                // ── Inline path: IDs embedded on the parent item ──
+                if (Array.isArray(idValue)) {
+                    const loaded = await Promise.all(idValue.map(async (keyObj) => {
+                        const result = await (0, client_1.getDocClient)().send(new lib_dynamodb_1.GetCommand({
+                            TableName: entityMetadata.tableName,
+                            Key: keyObj
+                        }));
+                        return result.Item ? instantiate(result.Item) : null;
+                    }));
+                    this[link.propertyKey] = loaded.filter(e => e !== null);
+                }
+                else {
+                    const result = await (0, client_1.getDocClient)().send(new lib_dynamodb_1.GetCommand({
+                        TableName: entityMetadata.tableName,
+                        Key: idValue
+                    }));
+                    if (result.Item) {
+                        this[link.propertyKey] = instantiate(result.Item);
+                    }
+                }
+            }
+            else if (parentMetadata.sortKeyName) {
+                // ── Non-inline path: look up separate link records, then fetch each entity ──
+                const parentHKVal = String(parentKey[parentMetadata.hashKeyName]);
+                const parentSKVal = String(parentKey[parentMetadata.sortKeyName]);
+                const skPrefix = `${(0, client_1.encodeLinkSegment)(parentHKVal)}#${(0, client_1.encodeLinkSegment)(parentSKVal)}#${(0, client_1.encodeLinkSegment)(link.propertyKey)}#`;
+                const linkItems = await (0, client_1.paginatedQuery)({
+                    TableName: parentMetadata.tableName,
+                    KeyConditionExpression: '#pk = :pkval AND begins_with(#sk, :skprefix)',
+                    ExpressionAttributeNames: {
+                        '#pk': parentMetadata.hashKeyName,
+                        '#sk': parentMetadata.sortKeyName
+                    },
+                    ExpressionAttributeValues: {
+                        ':pkval': '__link',
+                        ':skprefix': skPrefix
+                    }
+                });
+                if (linkItems.length === 0) {
+                    // For array links with no records, set to empty array instead of leaving undefined
+                    if (link.isArray) {
+                        this[link.propertyKey] = [];
+                    }
+                    continue;
+                }
+                const loaded = await Promise.all(linkItems.map(async (linkRecord) => {
+                    const linkedKey = {
+                        [entityMetadata.hashKeyName]: linkRecord.linkedHashKey
+                    };
+                    if (entityMetadata.sortKeyName) {
+                        linkedKey[entityMetadata.sortKeyName] = linkRecord.linkedSortKey;
+                    }
+                    const result = await (0, client_1.getDocClient)().send(new lib_dynamodb_1.GetCommand({
+                        TableName: entityMetadata.tableName,
+                        Key: linkedKey
+                    }));
+                    return result.Item ? instantiate(result.Item) : null;
+                }));
+                const filtered = loaded.filter(e => e !== null);
+                // Use stored link.isArray (from decoration time) to reconstruct the original shape
+                this[link.propertyKey] = link.isArray ? filtered : (filtered[0] ?? null);
+            }
+        }
+        return this;
+    }
+    static configure(dynamoDBClient, documentClientConfig) {
+        (0, client_1.configureClient)(dynamoDBClient, documentClientConfig);
+    }
+    static async get(sortKeyValue) {
+        const metadata = this.__entityMetadata__;
+        const tempInstance = new this();
+        const hashKeyValue = metadata.hashKeyGetter ? tempInstance[metadata.hashKeyGetter] : undefined;
+        const key = {
+            [metadata.hashKeyName]: hashKeyValue
+        };
+        if (metadata.sortKeyName && sortKeyValue !== undefined) {
+            key[metadata.sortKeyName] = sortKeyValue;
+        }
+        const result = await (0, client_1.getDocClient)().send(new lib_dynamodb_1.GetCommand({
+            TableName: metadata.tableName,
+            Key: key
+        }));
+        if (!result.Item) {
+            return null;
+        }
+        const fromDbModelMapper = this[symbols_1.FROM_DB_MODEL_METADATA];
+        let itemData = result.Item;
+        if (fromDbModelMapper) {
+            const mappedData = this[fromDbModelMapper](result.Item);
+            itemData = { ...result.Item, ...mappedData };
+        }
+        const instance = new this();
+        Object.assign(instance, itemData);
+        return instance;
+    }
+    static async query(options) {
+        const metadata = this.__entityMetadata__;
+        const tempInstance = new this();
+        const hashKeyValue = metadata.hashKeyGetter ? tempInstance[metadata.hashKeyGetter] : undefined;
+        let keyConditionExpression = `#hk = :hkval`;
+        const expressionAttributeNames = {
+            '#hk': metadata.hashKeyName
+        };
+        const expressionAttributeValues = {
+            ':hkval': hashKeyValue
+        };
+        if (options?.sortKeyCondition && metadata.sortKeyName) {
+            const sk = metadata.sortKeyName;
+            expressionAttributeNames['#sk'] = sk;
+            const condition = options.sortKeyCondition;
+            switch (condition.type) {
+                case 'equals':
+                    keyConditionExpression += ` AND #sk = :skval`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+                case 'lessThan':
+                    keyConditionExpression += ` AND #sk < :skval`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+                case 'lessThanOrEqual':
+                    keyConditionExpression += ` AND #sk <= :skval`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+                case 'greaterThan':
+                    keyConditionExpression += ` AND #sk > :skval`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+                case 'greaterThanOrEqual':
+                    keyConditionExpression += ` AND #sk >= :skval`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+                case 'between':
+                    keyConditionExpression += ` AND #sk BETWEEN :skstart AND :skend`;
+                    expressionAttributeValues[':skstart'] = condition.start;
+                    expressionAttributeValues[':skend'] = condition.end;
+                    break;
+                case 'startsWith':
+                    keyConditionExpression += ` AND begins_with(#sk, :skval)`;
+                    expressionAttributeValues[':skval'] = condition.value;
+                    break;
+            }
+        }
+        const queryParams = {
+            TableName: metadata.tableName,
+            KeyConditionExpression: keyConditionExpression,
+            ExpressionAttributeNames: expressionAttributeNames,
+            ExpressionAttributeValues: expressionAttributeValues
+        };
+        if (options?.limit) {
+            queryParams.Limit = options.limit;
+        }
+        if (options?.scanIndexForward !== undefined) {
+            queryParams.ScanIndexForward = options.scanIndexForward;
+        }
+        const result = await (0, client_1.getDocClient)().send(new lib_dynamodb_1.QueryCommand(queryParams));
+        if (!result.Items || result.Items.length === 0) {
+            return [];
+        }
+        const fromDbModelMapper = this[symbols_1.FROM_DB_MODEL_METADATA];
+        return result.Items.map(item => {
+            let itemData = item;
+            if (fromDbModelMapper) {
+                const mappedData = this[fromDbModelMapper](item);
+                itemData = { ...item, ...mappedData };
+            }
+            const instance = new this();
+            Object.assign(instance, itemData);
+            return instance;
+        });
+    }
+    static async queryAll(limit) {
+        return this.query({ limit });
+    }
+    static async queryStartsWith(sortKeyPrefix, limit) {
+        return this.query({
+            sortKeyCondition: { type: 'startsWith', value: sortKeyPrefix },
+            limit
+        });
+    }
+    static async queryBetween(start, end, limit) {
+        return this.query({
+            sortKeyCondition: { type: 'between', start, end },
+            limit
+        });
+    }
+    static async queryGreaterThan(sortKeyValue, limit) {
+        return this.query({
+            sortKeyCondition: { type: 'greaterThan', value: sortKeyValue },
+            limit
+        });
+    }
+    static async queryLessThan(sortKeyValue, limit) {
+        return this.query({
+            sortKeyCondition: { type: 'lessThan', value: sortKeyValue },
+            limit
+        });
+    }
+    static async queryEquals(sortKeyValue, limit) {
+        return this.query({
+            sortKeyCondition: { type: 'equals', value: sortKeyValue },
+            limit
+        });
+    }
+}
+exports.BaseEntity = BaseEntity;
+//# sourceMappingURL=BaseEntity.js.map

package/dist/BaseEntity.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,8 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
+export declare function configureClient(dynamoDBClient: DynamoDBClient, documentClientConfig?: any): void;
+export declare function isClientConfigured(): boolean;
+export declare function getDocClient(): DynamoDBDocumentClient;
+export declare function paginatedQuery(params: any): Promise<any[]>;
+export declare function encodeLinkSegment(v: string): string;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAgB,MAAM,uBAAuB,CAAC;AAI7E,wBAAgB,eAAe,CAAC,cAAc,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAAE,GAAG,GAAG,IAAI,CAEhG;AAED,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAED,wBAAgB,YAAY,IAAI,sBAAsB,CAOrD;AAGD,wBAAsB,cAAc,CAAC,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,CAYhE;AAGD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAEnD"}

package/dist/client.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configureClient = configureClient;
+exports.isClientConfigured = isClientConfigured;
+exports.getDocClient = getDocClient;
+exports.paginatedQuery = paginatedQuery;
+exports.encodeLinkSegment = encodeLinkSegment;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+let _docClient;
+function configureClient(dynamoDBClient, documentClientConfig) {
+    _docClient = lib_dynamodb_1.DynamoDBDocumentClient.from(dynamoDBClient, documentClientConfig);
+}
+function isClientConfigured() {
+    return _docClient !== undefined;
+}
+function getDocClient() {
+    if (!_docClient) {
+        throw new Error('DynamoDB client not configured. Call BaseEntity.configure(new DynamoDBClient({...})) before using the ORM.');
+    }
+    return _docClient;
+}
+// Exhaustively pages through a DynamoDB query, returning all matching items.
+async function paginatedQuery(params) {
+    const items = [];
+    let lastKey = undefined;
+    do {
+        const result = await getDocClient().send(new lib_dynamodb_1.QueryCommand({
+            ...params,
+            ...(lastKey ? { ExclusiveStartKey: lastKey } : {})
+        }));
+        if (result.Items)
+            items.push(...result.Items);
+        lastKey = result.LastEvaluatedKey;
+    } while (lastKey);
+    return items;
+}
+// Escapes '#' in composite sort key segments to avoid prefix ambiguity.
+function encodeLinkSegment(v) {
+    return v.replace(/#/g, '%23');
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../client.ts"],"names":[],"mappings":";;AAKA,0CAEC;AAED,gDAEC;AAED,oCAOC;AAGD,wCAYC;AAGD,8CAEC;AAvCD,wDAA6E;AAE7E,IAAI,UAA8C,CAAC;AAEnD,SAAgB,eAAe,CAAC,cAA8B,EAAE,oBAA0B;IACtF,UAAU,GAAG,qCAAsB,CAAC,IAAI,CAAC,cAAc,EAAE,oBAAoB,CAAC,CAAC;AACnF,CAAC;AAED,SAAgB,kBAAkB;IAC9B,OAAO,UAAU,KAAK,SAAS,CAAC;AACpC,CAAC;AAED,SAAgB,YAAY;IACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACX,4GAA4G,CAC/G,CAAC;IACN,CAAC;IACD,OAAO,UAAU,CAAC;AACtB,CAAC;AAED,6EAA6E;AACtE,KAAK,UAAU,cAAc,CAAC,MAAW;IAC5C,MAAM,KAAK,GAAU,EAAE,CAAC;IACxB,IAAI,OAAO,GAAoC,SAAS,CAAC;IACzD,GAAG,CAAC;QACA,MAAM,MAAM,GAA8D,MAAM,YAAY,EAAE,CAAC,IAAI,CAAC,IAAI,2BAAY,CAAC;YACjH,GAAG,MAAM;YACT,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,iBAAiB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrD,CAAC,CAAC,CAAC;QACJ,IAAI,MAAM,CAAC,KAAK;YAAE,KAAK,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,GAAG,MAAM,CAAC,gBAAgB,CAAC;IACtC,CAAC,QAAQ,OAAO,EAAE;IAClB,OAAO,KAAK,CAAC;AACjB,CAAC;AAED,wEAAwE;AACxE,SAAgB,iBAAiB,CAAC,CAAS;IACvC,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AAClC,CAAC"}

package/dist/decorators.d.ts

@@ -0,0 +1,14 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { BaseEntity } from './BaseEntity';
+export declare function Entity(tableName: string, hashKeyName: string, sortKeyName?: string, dbClient?: DynamoDBClient): <T extends new (...args: any[]) => BaseEntity>(constructor: T) => T;
+export declare function HashKeyValue(target: object, propertyKey: string, descriptor?: PropertyDescriptor): PropertyDescriptor | undefined;
+export declare function SortKeyValue(target: object, propertyKey: string, descriptor?: PropertyDescriptor): PropertyDescriptor | undefined;
+export declare function LinkObject(entityClass: new (...args: any[]) => BaseEntity, options?: {
+    inline?: boolean;
+}): (target: object, propertyKey: string) => void;
+export declare function LinkArray(entityClass: new (...args: any[]) => BaseEntity, options?: {
+    inline?: boolean;
+}): (target: object, propertyKey: string) => void;
+export declare function ToDbModel(target: any, propertyKey: string, descriptor?: PropertyDescriptor): PropertyDescriptor | undefined;
+export declare function FromDbModel(target: any, propertyKey: string, descriptor?: PropertyDescriptor): PropertyDescriptor | undefined;
+//# sourceMappingURL=decorators.d.ts.map

package/dist/decorators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../decorators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,wBAAgB,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,cAAc,IACzF,CAAC,SAAS,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,aAAa,CAAC,KA2BnD,CAAC,CAE9B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,kCAGhG;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,kCAGhG;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,IACrF,QAAQ,MAAM,EAAE,aAAa,MAAM,UAWvD;AAED,wBAAgB,SAAS,CAAC,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,EAAE,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,IACpF,QAAQ,MAAM,EAAE,aAAa,MAAM,UAWvD;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,kCAG1F;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,kCAG5F"}

package/dist/decorators.js

@@ -0,0 +1,80 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Entity = Entity;
+exports.HashKeyValue = HashKeyValue;
+exports.SortKeyValue = SortKeyValue;
+exports.LinkObject = LinkObject;
+exports.LinkArray = LinkArray;
+exports.ToDbModel = ToDbModel;
+exports.FromDbModel = FromDbModel;
+const symbols_1 = require("./symbols");
+const client_1 = require("./client");
+function Entity(tableName, hashKeyName, sortKeyName, dbClient) {
+    return function (constructor) {
+        // Configure DynamoDB client from the decorator only when explicitly provided.
+        if (!(0, client_1.isClientConfigured)() && dbClient) {
+            (0, client_1.configureClient)(dbClient);
+        }
+        // Guard against using the reserved '__link' / '__backlink' hash key values.
+        const hkGetter = constructor.prototype[symbols_1.HASH_KEY_METADATA];
+        if (hkGetter) {
+            const tempInstance = new constructor();
+            if (tempInstance[hkGetter] === '__link' || tempInstance[hkGetter] === '__backlink') {
+                throw new Error(`Entity "${constructor.name}" uses reserved hash key value "${tempInstance[hkGetter]}". ` +
+                    `This value is reserved for internal ORM records.`);
+            }
+        }
+        // Store metadata on the constructor
+        constructor.__entityMetadata__ = {
+            tableName: tableName || constructor.name,
+            hashKeyName,
+            sortKeyName,
+            hashKeyGetter: constructor.prototype[symbols_1.HASH_KEY_METADATA],
+            sortKeyGetter: constructor.prototype[symbols_1.SORT_KEY_METADATA]
+        };
+        return constructor;
+    };
+}
+function HashKeyValue(target, propertyKey, descriptor) {
+    target[symbols_1.HASH_KEY_METADATA] = propertyKey;
+    return descriptor;
+}
+function SortKeyValue(target, propertyKey, descriptor) {
+    target[symbols_1.SORT_KEY_METADATA] = propertyKey;
+    return descriptor;
+}
+function LinkObject(entityClass, options) {
+    return function (target, propertyKey) {
+        if (!target[symbols_1.LINKS_METADATA]) {
+            target[symbols_1.LINKS_METADATA] = [];
+        }
+        target[symbols_1.LINKS_METADATA].push({
+            propertyKey,
+            entityClass,
+            inline: options?.inline,
+            isArray: false
+        });
+    };
+}
+function LinkArray(entityClass, options) {
+    return function (target, propertyKey) {
+        if (!target[symbols_1.LINKS_METADATA]) {
+            target[symbols_1.LINKS_METADATA] = [];
+        }
+        target[symbols_1.LINKS_METADATA].push({
+            propertyKey,
+            entityClass,
+            inline: options?.inline,
+            isArray: true
+        });
+    };
+}
+function ToDbModel(target, propertyKey, descriptor) {
+    target[symbols_1.TO_DB_MODEL_METADATA] = propertyKey;
+    return descriptor;
+}
+function FromDbModel(target, propertyKey, descriptor) {
+    target[symbols_1.FROM_DB_MODEL_METADATA] = propertyKey;
+    return descriptor;
+}
+//# sourceMappingURL=decorators.js.map

package/dist/decorators.js.map

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

package/dist/dynamoDbORM.d.ts

@@ -0,0 +1,3 @@
+export { BaseEntity } from './BaseEntity';
+export { Entity, HashKeyValue, SortKeyValue, LinkObject, LinkArray, ToDbModel, FromDbModel, } from './decorators';
+//# sourceMappingURL=dynamoDbORM.d.ts.map

package/dist/dynamoDbORM.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamoDbORM.d.ts","sourceRoot":"","sources":["../dynamoDbORM.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EACH,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,GACd,MAAM,cAAc,CAAC"}

package/dist/dynamoDbORM.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FromDbModel = exports.ToDbModel = exports.LinkArray = exports.LinkObject = exports.SortKeyValue = exports.HashKeyValue = exports.Entity = exports.BaseEntity = void 0;
+var BaseEntity_1 = require("./BaseEntity");
+Object.defineProperty(exports, "BaseEntity", { enumerable: true, get: function () { return BaseEntity_1.BaseEntity; } });
+var decorators_1 = require("./decorators");
+Object.defineProperty(exports, "Entity", { enumerable: true, get: function () { return decorators_1.Entity; } });
+Object.defineProperty(exports, "HashKeyValue", { enumerable: true, get: function () { return decorators_1.HashKeyValue; } });
+Object.defineProperty(exports, "SortKeyValue", { enumerable: true, get: function () { return decorators_1.SortKeyValue; } });
+Object.defineProperty(exports, "LinkObject", { enumerable: true, get: function () { return decorators_1.LinkObject; } });
+Object.defineProperty(exports, "LinkArray", { enumerable: true, get: function () { return decorators_1.LinkArray; } });
+Object.defineProperty(exports, "ToDbModel", { enumerable: true, get: function () { return decorators_1.ToDbModel; } });
+Object.defineProperty(exports, "FromDbModel", { enumerable: true, get: function () { return decorators_1.FromDbModel; } });
+//# sourceMappingURL=dynamoDbORM.js.map

package/dist/dynamoDbORM.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dynamoDbORM.js","sourceRoot":"","sources":["../dynamoDbORM.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,2CAQsB;AAPlB,oGAAA,MAAM,OAAA;AACN,0GAAA,YAAY,OAAA;AACZ,0GAAA,YAAY,OAAA;AACZ,wGAAA,UAAU,OAAA;AACV,uGAAA,SAAS,OAAA;AACT,uGAAA,SAAS,OAAA;AACT,yGAAA,WAAW,OAAA"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './dynamoDbORM';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dynamoDbORM"), exports);
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B"}

package/dist/symbols.d.ts

@@ -0,0 +1,6 @@
+export declare const HASH_KEY_METADATA: unique symbol;
+export declare const SORT_KEY_METADATA: unique symbol;
+export declare const LINKS_METADATA: unique symbol;
+export declare const TO_DB_MODEL_METADATA: unique symbol;
+export declare const FROM_DB_MODEL_METADATA: unique symbol;
+//# sourceMappingURL=symbols.d.ts.map

package/dist/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../symbols.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB,eAAoB,CAAC;AACnD,eAAO,MAAM,iBAAiB,eAAoB,CAAC;AACnD,eAAO,MAAM,cAAc,eAAkB,CAAC;AAC9C,eAAO,MAAM,oBAAoB,eAAsB,CAAC;AACxD,eAAO,MAAM,sBAAsB,eAAwB,CAAC"}

package/dist/symbols.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FROM_DB_MODEL_METADATA = exports.TO_DB_MODEL_METADATA = exports.LINKS_METADATA = exports.SORT_KEY_METADATA = exports.HASH_KEY_METADATA = void 0;
+exports.HASH_KEY_METADATA = Symbol('hashKey');
+exports.SORT_KEY_METADATA = Symbol('sortKey');
+exports.LINKS_METADATA = Symbol('links');
+exports.TO_DB_MODEL_METADATA = Symbol('toDbModel');
+exports.FROM_DB_MODEL_METADATA = Symbol('fromDbModel');
+//# sourceMappingURL=symbols.js.map

package/dist/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../symbols.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AACtC,QAAA,iBAAiB,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;AACtC,QAAA,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;AACjC,QAAA,oBAAoB,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC;AAC3C,QAAA,sBAAsB,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,43 @@
+import type { BaseEntity } from './BaseEntity';
+export interface LinkMetadata {
+    propertyKey: string;
+    entityClass: new (...args: any[]) => BaseEntity;
+    inline?: boolean;
+    isArray: boolean;
+}
+export type SortKeyCondition = {
+    type: 'equals';
+    value: any;
+} | {
+    type: 'lessThan';
+    value: any;
+} | {
+    type: 'lessThanOrEqual';
+    value: any;
+} | {
+    type: 'greaterThan';
+    value: any;
+} | {
+    type: 'greaterThanOrEqual';
+    value: any;
+} | {
+    type: 'between';
+    start: any;
+    end: any;
+} | {
+    type: 'startsWith';
+    value: string;
+};
+export interface QueryOptions {
+    sortKeyCondition?: SortKeyCondition;
+    limit?: number;
+    scanIndexForward?: boolean;
+}
+export interface EntityMetadata {
+    tableName?: string;
+    hashKeyName: string;
+    sortKeyName?: string;
+    hashKeyGetter?: string;
+    sortKeyGetter?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,WAAW,YAAY;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,UAAU,CAAC;IAChD,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,gBAAgB,GACtB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,iBAAiB,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,oBAAoB,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,GAC1C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,GAAG,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,MAAM,WAAW,YAAY;IACzB,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "orm-dynamodb",
+  "version": "1.0.0",
+  "description": "Lightweight TypeScript decorators for modeling DynamoDB items as classes",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "clean": "rm -rf dist",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "dev": "tsx examples.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:ui": "vitest --ui",
+    "prepack": "npm run build",
+    "pack:check": "npm pack --dry-run"
+  },
+  "keywords": [
+    "dynamodb",
+    "orm-dynamodb",
+    "decorators",
+    "orm",
+    "typescript"
+  ],
+  "license": "ISC",
+  "dependencies": {
+    "@aws-sdk/client-dynamodb": "^3.0.0",
+    "@aws-sdk/lib-dynamodb": "^3.0.0",
+    "dotenv": "^17.4.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@vitest/ui": "^4.1.4",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0",
+    "vitest": "^4.1.4"
+  },
+  "packageManager": "pnpm@10.11.0+sha512.6540583f41cc5f628eb3d9773ecee802f4f9ef9923cc45b69890fb47991d4b092964694ec3a4f738a420c918a333062c8b925d312f42e4f0c263eb603551f977"
+}