@ftschopp/dynatable-core 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,62 @@
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([e282548](https://github.com/ftschopp/dynatable/commit/e28254895a40fdc26bab1dde2c634f663857ec16))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([e282548](https://github.com/ftschopp/dynatable/commit/e28254895a40fdc26bab1dde2c634f663857ec16))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# @ftschopp/dynatable-core 1.0.0 (2026-01-10)
+
+
+### Features
+
+* major initial release ([fc6e561](https://github.com/ftschopp/dynatable/commit/fc6e561a4b06507a7acd9ae6fb594936a65d7c4f))
+
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

package/README.md

@@ -0,0 +1,17 @@
+# @ftschopp/dynatable-core
+
+A type-safe, functional programming library for AWS DynamoDB with Single Table Design support.
+
+## Installation
+
+```bash
+npm install @ftschopp/dynatable-core
+```
+
+## Documentation
+
+See the [main repository](https://github.com/ftschopp/dynatable) for full documentation and examples.
+
+## License
+
+MIT

package/dist/builders/batch-get/create-batch-get-builder.d.ts

@@ -0,0 +1,18 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { BatchGetBuilder } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates a BatchGetBuilder to retrieve multiple items by their keys.
+ *
+ * @param requestItems - An object where keys are table names and values are objects containing Keys array
+ * @param client - DynamoDB client instance
+ * @param options - Optional configuration (projection, consistentRead)
+ * @param logger - Optional logger instance
+ */
+export declare function createBatchGetBuilder<Model>(requestItems: Record<string, {
+    Keys: any[];
+}>, client: DynamoDBClient, options?: {
+    projection?: (keyof Model)[];
+    consistentRead?: boolean;
+}, logger?: DynamoDBLogger): BatchGetBuilder<Model>;
+//# sourceMappingURL=create-batch-get-builder.d.ts.map

package/dist/builders/batch-get/create-batch-get-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-batch-get-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-get/create-batch-get-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EACzC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,GAAG,EAAE,CAAA;CAAE,CAAC,EAC7C,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B,EACD,MAAM,CAAC,EAAE,cAAc,GACtB,eAAe,CAAC,KAAK,CAAC,CA+ExB"}

package/dist/builders/batch-get/create-batch-get-builder.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBatchGetBuilder = createBatchGetBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Creates a BatchGetBuilder to retrieve multiple items by their keys.
+ *
+ * @param requestItems - An object where keys are table names and values are objects containing Keys array
+ * @param client - DynamoDB client instance
+ * @param options - Optional configuration (projection, consistentRead)
+ * @param logger - Optional logger instance
+ */
+function createBatchGetBuilder(requestItems, client, options, logger) {
+    const projection = options?.projection ?? [];
+    const isConsistent = options?.consistentRead ?? false;
+    return {
+        /**
+         * Select only specific attributes to retrieve.
+         */
+        select(attrs) {
+            return createBatchGetBuilder(requestItems, client, {
+                projection: attrs,
+                consistentRead: isConsistent,
+            }, logger);
+        },
+        /**
+         * Enable strongly consistent read.
+         */
+        consistentRead() {
+            return createBatchGetBuilder(requestItems, client, {
+                projection,
+                consistentRead: true,
+            }, logger);
+        },
+        /**
+         * Build the underlying DynamoDB input parameters.
+         */
+        dbParams() {
+            // Apply projection and consistentRead to all tables
+            const enhancedRequestItems = Object.entries(requestItems).reduce((acc, [tableName, tableRequest]) => {
+                acc[tableName] = {
+                    Keys: tableRequest.Keys,
+                    ...(projection.length > 0 && {
+                        ProjectionExpression: projection.join(', '),
+                    }),
+                    ...(isConsistent && { ConsistentRead: true }),
+                };
+                return acc;
+            }, {});
+            return {
+                RequestItems: enhancedRequestItems,
+            };
+        },
+        /**
+         * Execute the BatchGetItem command and return the items.
+         */
+        async execute() {
+            const params = this.dbParams();
+            const result = await client.send(new lib_dynamodb_1.BatchGetCommand(params));
+            logger?.log('BatchGetCommand', params, result);
+            // Transform the response into a more usable format
+            const responses = {};
+            if (result.Responses) {
+                for (const [tableName, items] of Object.entries(result.Responses)) {
+                    responses[tableName] = items;
+                }
+            }
+            return responses;
+        },
+    };
+}

package/dist/builders/batch-get/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './create-batch-get-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/batch-get/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-get/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,4BAA4B,CAAC"}

package/dist/builders/batch-get/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("./types"), exports);
+__exportStar(require("./create-batch-get-builder"), exports);

package/dist/builders/batch-get/types.d.ts

@@ -0,0 +1,25 @@
+import { BatchGetItemCommandInput } from '@aws-sdk/client-dynamodb';
+/**
+ * BatchGetBuilder allows you to retrieve multiple items from one or more tables
+ * in a single request.
+ */
+export type BatchGetBuilder<Model> = {
+    /**
+     * Select only specific attributes to retrieve for all items.
+     */
+    select(attrs: (keyof Model)[]): BatchGetBuilder<Model>;
+    /**
+     * Enable strongly consistent read for all items.
+     */
+    consistentRead(): BatchGetBuilder<Model>;
+    /**
+     * Build the underlying DynamoDB BatchGetItem input parameters.
+     */
+    dbParams(): BatchGetItemCommandInput;
+    /**
+     * Execute the BatchGetItem command and return the items.
+     * Returns an object mapping table names to arrays of items.
+     */
+    execute(): Promise<Record<string, Model[]>>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/batch-get/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-get/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,KAAK,IAAI;IACnC;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAEvD;;OAEG;IACH,cAAc,IAAI,eAAe,CAAC,KAAK,CAAC,CAAC;IAEzC;;OAEG;IACH,QAAQ,IAAI,wBAAwB,CAAC;IAErC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;CAC7C,CAAC"}

package/dist/builders/batch-get/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/builders/batch-write/create-batch-write-builder.d.ts

@@ -0,0 +1,12 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { BatchWriteBuilder, WriteRequest } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates a BatchWriteBuilder to put or delete multiple items.
+ *
+ * @param requestItems - An object where keys are table names and values are arrays of WriteRequest
+ * @param client - DynamoDB client instance
+ * @param logger - Optional logger instance
+ */
+export declare function createBatchWriteBuilder(requestItems: Record<string, WriteRequest[]>, client: DynamoDBClient, logger?: DynamoDBLogger): BatchWriteBuilder;
+//# sourceMappingURL=create-batch-write-builder.d.ts.map

package/dist/builders/batch-write/create-batch-write-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-batch-write-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-write/create-batch-write-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAM1D,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,EAC5C,MAAM,EAAE,cAAc,EACtB,MAAM,CAAC,EAAE,cAAc,GACtB,iBAAiB,CA2BnB"}

package/dist/builders/batch-write/create-batch-write-builder.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBatchWriteBuilder = createBatchWriteBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Creates a BatchWriteBuilder to put or delete multiple items.
+ *
+ * @param requestItems - An object where keys are table names and values are arrays of WriteRequest
+ * @param client - DynamoDB client instance
+ * @param logger - Optional logger instance
+ */
+function createBatchWriteBuilder(requestItems, client, logger) {
+    return {
+        /**
+         * Build the underlying DynamoDB input parameters.
+         */
+        dbParams() {
+            return {
+                RequestItems: requestItems,
+            };
+        },
+        /**
+         * Execute the BatchWriteItem command.
+         */
+        async execute() {
+            const params = this.dbParams();
+            const result = await client.send(new lib_dynamodb_1.BatchWriteCommand(params));
+            logger?.log('BatchWriteCommand', params, result);
+            // Return unprocessed items if any
+            return {
+                unprocessedItems: result.UnprocessedItems,
+            };
+        },
+    };
+}

package/dist/builders/batch-write/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './create-batch-write-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/batch-write/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-write/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,8BAA8B,CAAC"}

package/dist/builders/batch-write/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("./types"), exports);
+__exportStar(require("./create-batch-write-builder"), exports);

package/dist/builders/batch-write/types.d.ts

@@ -0,0 +1,30 @@
+import { BatchWriteItemCommandInput } from '@aws-sdk/client-dynamodb';
+/**
+ * A single write request that can be either a PutRequest or DeleteRequest
+ */
+export type WriteRequest = {
+    PutRequest?: {
+        Item: any;
+    };
+    DeleteRequest?: {
+        Key: any;
+    };
+};
+/**
+ * BatchWriteBuilder allows you to put or delete multiple items from one or more tables
+ * in a single request.
+ */
+export type BatchWriteBuilder = {
+    /**
+     * Build the underlying DynamoDB BatchWriteItem input parameters.
+     */
+    dbParams(): BatchWriteItemCommandInput;
+    /**
+     * Execute the BatchWriteItem command.
+     * Returns unprocessed items if any requests failed.
+     */
+    execute(): Promise<{
+        unprocessedItems?: Record<string, WriteRequest[]>;
+    }>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/batch-write/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-write/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,CAAC,EAAE;QACX,IAAI,EAAE,GAAG,CAAC;KACX,CAAC;IACF,aAAa,CAAC,EAAE;QACd,GAAG,EAAE,GAAG,CAAC;KACV,CAAC;CACH,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;OAEG;IACH,QAAQ,IAAI,0BAA0B,CAAC;IAEvC;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC;QACjB,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC;KACnD,CAAC,CAAC;CACJ,CAAC"}

package/dist/builders/batch-write/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/builders/delete/create-delete-builder.d.ts

@@ -0,0 +1,9 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { Condition } from '../shared';
+import { DeleteBuilder } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates a DeleteBuilder for an item key and table.
+ */
+export declare function createDeleteBuilder<Model>(tableName: string, key: Partial<Model>, client: DynamoDBClient, prevConditions?: Condition[], returnMode?: 'NONE' | 'ALL_OLD', logger?: DynamoDBLogger): DeleteBuilder<Model>;
+//# sourceMappingURL=create-delete-builder.d.ts.map

package/dist/builders/delete/create-delete-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-delete-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/delete/create-delete-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAgC,SAAS,EAAmB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EACvC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,OAAO,CAAC,KAAK,CAAC,EACnB,MAAM,EAAE,cAAc,EACtB,cAAc,GAAE,SAAS,EAAO,EAChC,UAAU,GAAE,MAAM,GAAG,SAAkB,EACvC,MAAM,CAAC,EAAE,cAAc,GACtB,aAAa,CAAC,KAAK,CAAC,CAkFtB"}

package/dist/builders/delete/create-delete-builder.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createDeleteBuilder = createDeleteBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const shared_1 = require("../shared");
+/**
+ * Creates a DeleteBuilder for an item key and table.
+ */
+function createDeleteBuilder(tableName, key, client, prevConditions = [], returnMode = 'NONE', logger) {
+    const conditions = [...prevConditions];
+    const build = () => ({
+        where(fn) {
+            const attrs = new Proxy({}, {
+                get(_, prop) {
+                    return { name: prop };
+                },
+            });
+            const opBuilder = (0, shared_1.createOpBuilder)();
+            const condition = fn(attrs, opBuilder);
+            return createDeleteBuilder(tableName, key, client, [...conditions, condition], returnMode, logger);
+        },
+        returning(mode) {
+            return createDeleteBuilder(tableName, key, client, conditions, mode, logger);
+        },
+        dbParams() {
+            // Build ConditionExpression from condition tree
+            let conditionExpression = '';
+            let expressionAttributeNames = {};
+            let expressionAttributeValues = {};
+            if (conditions.length > 0) {
+                const combinedCondition = conditions.length === 1 && conditions[0]
+                    ? conditions[0]
+                    : {
+                        expression: '',
+                        operator: 'AND',
+                        children: conditions,
+                    };
+                const result = (0, shared_1.buildExpression)(combinedCondition);
+                conditionExpression = result.expression;
+                expressionAttributeNames = result.names;
+                expressionAttributeValues = result.values;
+            }
+            const extra = returnMode !== 'NONE' ? { ReturnValues: returnMode } : {};
+            return {
+                TableName: tableName,
+                Key: key,
+                ...(conditionExpression && {
+                    ConditionExpression: conditionExpression,
+                }),
+                ...(Object.keys(expressionAttributeNames).length && {
+                    ExpressionAttributeNames: expressionAttributeNames,
+                }),
+                ...(Object.keys(expressionAttributeValues).length && {
+                    ExpressionAttributeValues: expressionAttributeValues,
+                }),
+                ...extra,
+            };
+        },
+        async execute() {
+            const params = build().dbParams();
+            const response = await client.send(new lib_dynamodb_1.DeleteCommand(params));
+            logger?.log('DeleteCommand', params, response);
+            // Return the deleted item if returnMode is ALL_OLD
+            if (returnMode === 'ALL_OLD' && response.Attributes) {
+                return response.Attributes;
+            }
+            // For NONE mode, return the key as a fallback
+            return key;
+        },
+    });
+    return build();
+}

package/dist/builders/delete/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './create-delete-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/delete/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/delete/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,yBAAyB,CAAC"}

package/dist/builders/delete/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("./types"), exports);
+__exportStar(require("./create-delete-builder"), exports);

package/dist/builders/delete/types.d.ts

@@ -0,0 +1,11 @@
+import { OperationBuilder } from '../shared';
+/**
+ * Builder interface for DynamoDB DeleteItem operations
+ */
+export interface DeleteBuilder<Model> extends OperationBuilder<Model> {
+    /**
+     * Configures what values should be returned after the delete operation
+     */
+    returning(mode: 'NONE' | 'ALL_OLD'): DeleteBuilder<Model>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/delete/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/delete/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,gBAAgB,CAAC,KAAK,CAAC;IACnE;;OAEG;IACH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;CAC3D"}

package/dist/builders/delete/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/builders/get/create-get-builder.d.ts

@@ -0,0 +1,12 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { GetBuilder } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates a GetBuilder to retrieve an item by its key.
+ */
+export declare function createGetBuilder<KeyInput, Model>(tableName: string, key: Record<string, any>, client: DynamoDBClient, options?: {
+    projection?: (keyof Model)[];
+    consistentRead?: boolean;
+    returnConsumedCapacity?: 'INDEXES' | 'TOTAL' | 'NONE';
+}, logger?: DynamoDBLogger): GetBuilder<KeyInput, Model>;
+//# sourceMappingURL=create-get-builder.d.ts.map

package/dist/builders/get/create-get-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-get-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/get/create-get-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AA0B7D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,KAAK,EAC9C,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sBAAsB,CAAC,EAAE,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;CACvD,EACD,MAAM,CAAC,EAAE,cAAc,GACtB,UAAU,CAAC,QAAQ,EAAE,KAAK,CAAC,CAgG7B"}

package/dist/builders/get/create-get-builder.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGetBuilder = createGetBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Builds a ProjectionExpression with proper ExpressionAttributeNames
+ * to handle reserved words and special characters.
+ */
+function buildProjectionExpression(attrs) {
+    const names = {};
+    const projectionParts = [];
+    attrs.forEach((attr) => {
+        // Use a placeholder for the attribute name to avoid reserved word conflicts
+        const placeholder = `#${attr}`;
+        names[placeholder] = attr;
+        projectionParts.push(placeholder);
+    });
+    return {
+        ProjectionExpression: projectionParts.join(', '),
+        ExpressionAttributeNames: names,
+    };
+}
+/**
+ * Creates a GetBuilder to retrieve an item by its key.
+ */
+function createGetBuilder(tableName, key, client, options, logger) {
+    const projection = options?.projection ?? [];
+    const isConsistent = options?.consistentRead ?? false;
+    const consumedCapacity = options?.returnConsumedCapacity;
+    return {
+        /**
+         * Select only specific attributes to retrieve.
+         */
+        select(attrs) {
+            return createGetBuilder(tableName, key, client, {
+                projection: attrs,
+                consistentRead: isConsistent,
+                returnConsumedCapacity: consumedCapacity,
+            }, logger);
+        },
+        /**
+         * Enable strongly consistent read.
+         */
+        consistentRead() {
+            return createGetBuilder(tableName, key, client, {
+                projection,
+                consistentRead: true,
+                returnConsumedCapacity: consumedCapacity,
+            }, logger);
+        },
+        /**
+         * Configure ReturnConsumedCapacity parameter.
+         */
+        returnConsumedCapacity(mode) {
+            return createGetBuilder(tableName, key, client, {
+                projection,
+                consistentRead: isConsistent,
+                returnConsumedCapacity: mode,
+            }, logger);
+        },
+        /**
+         * Build the underlying DynamoDB input parameters.
+         */
+        dbParams() {
+            const params = {
+                TableName: tableName,
+                Key: key,
+            };
+            // Add projection with proper ExpressionAttributeNames
+            if (projection.length > 0) {
+                const projectionExpr = buildProjectionExpression(projection);
+                params.ProjectionExpression = projectionExpr.ProjectionExpression;
+                params.ExpressionAttributeNames = projectionExpr.ExpressionAttributeNames;
+            }
+            // Add consistent read if enabled
+            if (isConsistent) {
+                params.ConsistentRead = true;
+            }
+            // Add ReturnConsumedCapacity if specified
+            if (consumedCapacity) {
+                params.ReturnConsumedCapacity = consumedCapacity;
+            }
+            return params;
+        },
+        /**
+         * Execute the GetItem command and return the item if found.
+         */
+        async execute() {
+            const params = this.dbParams();
+            const result = await client.send(new lib_dynamodb_1.GetCommand(params));
+            logger?.log('GetCommand', params, result);
+            return result.Item;
+        },
+    };
+}

package/dist/builders/get/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './create-get-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/get/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/builders/get/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC"}

package/dist/builders/get/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("./types"), exports);
+__exportStar(require("./create-get-builder"), exports);