@ftschopp/dynatable-core 1.0.0

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

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransactGetBuilder = void 0;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Creates the initial state for a TransactGet builder
+ */
+const createInitialState = (client) => ({
+    client,
+    items: [],
+});
+/**
+ * Adds a Get operation to the transaction
+ */
+const addGetItem = (state) => (params) => ({
+    ...state,
+    items: [...state.items, { Get: params }],
+});
+/**
+ * Converts the builder state to DynamoDB parameters
+ */
+const toDbParams = (state) => ({
+    TransactItems: [...state.items],
+});
+/**
+ * Executes the transaction and returns the items
+ */
+const execute = async (state) => {
+    const params = toDbParams(state);
+    const command = new lib_dynamodb_1.TransactGetCommand(params);
+    const response = await state.client.send(command);
+    return response.Responses?.map((r) => r.Item) || [];
+};
+/**
+ * Creates a builder from the current state
+ */
+const createBuilder = (state) => ({
+    addGet: (params) => createBuilder(addGetItem(state)(params)),
+    dbParams: () => toDbParams(state),
+    execute: () => execute(state),
+});
+/**
+ * Creates a new TransactGet builder
+ *
+ * @param client - DynamoDB client instance
+ * @returns A TransactGetBuilder
+ *
+ * @example
+ * ```typescript
+ * const [user, photo] = await createTransactGetBuilder(client)
+ *   .addGet(getUserParams)
+ *   .addGet(getPhotoParams)
+ *   .execute();
+ * ```
+ */
+const createTransactGetBuilder = (client) => {
+    const initialState = createInitialState(client);
+    return createBuilder(initialState);
+};
+exports.createTransactGetBuilder = createTransactGetBuilder;

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

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

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

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

package/dist/builders/transact-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-transact-get-builder"), exports);

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

@@ -0,0 +1,28 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+/**
+ * Represents a single Get operation in a TransactGet
+ */
+export type TransactGetItem = {
+    Get: {
+        TableName: string;
+        Key: Record<string, any>;
+        ProjectionExpression?: string;
+        ExpressionAttributeNames?: Record<string, string>;
+    };
+};
+/**
+ * State for the TransactGet builder
+ */
+export type TransactGetState = {
+    readonly client: DynamoDBClient;
+    readonly items: readonly TransactGetItem[];
+};
+/**
+ * TransactGet builder interface
+ */
+export type TransactGetBuilder = {
+    readonly addGet: (params: any) => TransactGetBuilder;
+    readonly dbParams: () => any;
+    readonly execute: () => Promise<any[]>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/transact-get/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,EAAE;QACH,SAAS,EAAE,MAAM,CAAC;QAClB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACnD,CAAC;CACH,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,eAAe,EAAE,CAAC;CAC5C,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,kBAAkB,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;CACxC,CAAC"}

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

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

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

@@ -0,0 +1,18 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { TransactWriteBuilder } from './types';
+/**
+ * Creates a new TransactWrite builder
+ *
+ * @param client - DynamoDB client instance
+ * @returns A TransactWriteBuilder
+ *
+ * @example
+ * ```typescript
+ * const result = await createTransactWriteBuilder(client)
+ *   .addPut(putParams)
+ *   .addUpdate(updateParams)
+ *   .execute();
+ * ```
+ */
+export declare const createTransactWriteBuilder: (client: DynamoDBClient) => TransactWriteBuilder;
+//# sourceMappingURL=create-transact-write-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-transact-write-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/transact-write/create-transact-write-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,oBAAoB,EAAsB,MAAM,SAAS,CAAC;AAiGnE;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,0BAA0B,GAAI,QAAQ,cAAc,KAAG,oBAGnE,CAAC"}

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

@@ -0,0 +1,97 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createTransactWriteBuilder = void 0;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+/**
+ * Creates the initial state for a TransactWrite builder
+ */
+const createInitialState = (client) => ({
+    client,
+    items: [],
+});
+/**
+ * Adds a Put operation to the transaction
+ */
+const addPutItem = (state) => (params) => ({
+    ...state,
+    items: [...state.items, { Put: params }],
+});
+/**
+ * Adds an Update operation to the transaction
+ */
+const addUpdateItem = (state) => (params) => ({
+    ...state,
+    items: [...state.items, { Update: params }],
+});
+/**
+ * Adds a Delete operation to the transaction
+ */
+const addDeleteItem = (state) => (params) => ({
+    ...state,
+    items: [...state.items, { Delete: params }],
+});
+/**
+ * Adds a ConditionCheck operation to the transaction
+ */
+const addConditionCheckItem = (state) => (params) => ({
+    ...state,
+    items: [...state.items, { ConditionCheck: params }],
+});
+/**
+ * Sets the client request token for idempotency
+ */
+const setClientRequestToken = (state) => (token) => ({
+    ...state,
+    clientRequestToken: token,
+});
+/**
+ * Converts the builder state to DynamoDB parameters
+ */
+const toDbParams = (state) => {
+    const params = {
+        TransactItems: state.items,
+    };
+    if (state.clientRequestToken) {
+        params.ClientRequestToken = state.clientRequestToken;
+    }
+    return params;
+};
+/**
+ * Executes the transaction
+ */
+const execute = async (state) => {
+    const params = toDbParams(state);
+    const command = new lib_dynamodb_1.TransactWriteCommand(params);
+    return await state.client.send(command);
+};
+/**
+ * Creates a builder from the current state
+ */
+const createBuilder = (state) => ({
+    addPut: (params) => createBuilder(addPutItem(state)(params)),
+    addUpdate: (params) => createBuilder(addUpdateItem(state)(params)),
+    addDelete: (params) => createBuilder(addDeleteItem(state)(params)),
+    addConditionCheck: (params) => createBuilder(addConditionCheckItem(state)(params)),
+    withClientRequestToken: (token) => createBuilder(setClientRequestToken(state)(token)),
+    dbParams: () => toDbParams(state),
+    execute: () => execute(state),
+});
+/**
+ * Creates a new TransactWrite builder
+ *
+ * @param client - DynamoDB client instance
+ * @returns A TransactWriteBuilder
+ *
+ * @example
+ * ```typescript
+ * const result = await createTransactWriteBuilder(client)
+ *   .addPut(putParams)
+ *   .addUpdate(updateParams)
+ *   .execute();
+ * ```
+ */
+const createTransactWriteBuilder = (client) => {
+    const initialState = createInitialState(client);
+    return createBuilder(initialState);
+};
+exports.createTransactWriteBuilder = createTransactWriteBuilder;

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

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

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

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

package/dist/builders/transact-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-transact-write-builder"), exports);

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

@@ -0,0 +1,34 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+/**
+ * Represents a single item in a TransactWrite operation
+ */
+export type TransactWriteItem = {
+    Put: any;
+} | {
+    Update: any;
+} | {
+    Delete: any;
+} | {
+    ConditionCheck: any;
+};
+/**
+ * State for the TransactWrite builder
+ */
+export type TransactWriteState = {
+    readonly client: DynamoDBClient;
+    readonly items: readonly TransactWriteItem[];
+    readonly clientRequestToken?: string;
+};
+/**
+ * TransactWrite builder interface
+ */
+export type TransactWriteBuilder = {
+    readonly addPut: (params: any) => TransactWriteBuilder;
+    readonly addUpdate: (params: any) => TransactWriteBuilder;
+    readonly addDelete: (params: any) => TransactWriteBuilder;
+    readonly addConditionCheck: (params: any) => TransactWriteBuilder;
+    readonly withClientRequestToken: (token: string) => TransactWriteBuilder;
+    readonly dbParams: () => any;
+    readonly execute: () => Promise<any>;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/transact-write/types.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,GAAG,EAAE,GAAG,CAAA;CAAE,GACZ;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,GACf;IAAE,MAAM,EAAE,GAAG,CAAA;CAAE,GACf;IAAE,cAAc,EAAE,GAAG,CAAA;CAAE,CAAC;AAE5B;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,MAAM,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,oBAAoB,CAAC;IACvD,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,oBAAoB,CAAC;IAC1D,QAAQ,CAAC,SAAS,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,oBAAoB,CAAC;IAC1D,QAAQ,CAAC,iBAAiB,EAAE,CAAC,MAAM,EAAE,GAAG,KAAK,oBAAoB,CAAC;IAClE,QAAQ,CAAC,sBAAsB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,oBAAoB,CAAC;IACzE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;CACtC,CAAC"}

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

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

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

@@ -0,0 +1,14 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { Condition } from '../shared';
+import { UpdateBuilder, UpdateAction } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates an UpdateBuilder for an item key and table.
+ */
+export declare function createUpdateBuilder<Model>(tableName: string, key: Partial<Model>, client: DynamoDBClient, prevConditions?: Condition[], updateActions?: {
+    set: UpdateAction[];
+    remove: UpdateAction[];
+    add: UpdateAction[];
+    delete: UpdateAction[];
+}, returnMode?: 'NONE' | 'ALL_OLD' | 'ALL_NEW' | 'UPDATED_OLD' | 'UPDATED_NEW', valueCounter?: number, enableTimestamps?: boolean, logger?: DynamoDBLogger): UpdateBuilder<Model>;
+//# sourceMappingURL=create-update-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-update-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/update/create-update-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAgC,SAAS,EAA4B,MAAM,WAAW,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACtD,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,aAAa,GAAE;IACb,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,GAAG,EAAE,YAAY,EAAE,CAAC;IACpB,MAAM,EAAE,YAAY,EAAE,CAAC;CACuB,EAChD,UAAU,GAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,aAAsB,EACnF,YAAY,SAAI,EAChB,gBAAgB,UAAQ,EACxB,MAAM,CAAC,EAAE,cAAc,GACtB,aAAa,CAAC,KAAK,CAAC,CAkQtB"}

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

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createUpdateBuilder = createUpdateBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const shared_1 = require("../shared");
+/**
+ * Creates an UpdateBuilder for an item key and table.
+ */
+function createUpdateBuilder(tableName, key, client, prevConditions = [], updateActions = { set: [], remove: [], add: [], delete: [] }, returnMode = 'NONE', valueCounter = 0, enableTimestamps = false, logger) {
+    const conditions = [...prevConditions];
+    const getUniqueValueName = (baseName) => {
+        return `${baseName}_${valueCounter++}`;
+    };
+    const normalizeAttr = (attr) => {
+        if (typeof attr === 'string') {
+            return attr;
+        }
+        return attr.name;
+    };
+    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 createUpdateBuilder(tableName, key, client, [...conditions, condition], updateActions, returnMode, valueCounter, enableTimestamps, logger);
+        },
+        set(attr, value) {
+            const attrName = normalizeAttr(attr);
+            const valueName = getUniqueValueName(attrName);
+            const action = {
+                expression: `#${attrName} = :${valueName}`,
+                names: { [`#${attrName}`]: attrName },
+                values: { [`:${valueName}`]: value },
+            };
+            return createUpdateBuilder(tableName, key, client, conditions, { ...updateActions, set: [...updateActions.set, action] }, returnMode, valueCounter, enableTimestamps, logger);
+        },
+        remove(attr) {
+            const attrName = normalizeAttr(attr);
+            const action = {
+                expression: `#${attrName}`,
+                names: { [`#${attrName}`]: attrName },
+            };
+            return createUpdateBuilder(tableName, key, client, conditions, { ...updateActions, remove: [...updateActions.remove, action] }, returnMode, valueCounter, enableTimestamps, logger);
+        },
+        add(attr, value) {
+            const attrName = normalizeAttr(attr);
+            const valueName = getUniqueValueName(attrName);
+            const action = {
+                expression: `#${attrName} :${valueName}`,
+                names: { [`#${attrName}`]: attrName },
+                values: { [`:${valueName}`]: value },
+            };
+            return createUpdateBuilder(tableName, key, client, conditions, { ...updateActions, add: [...updateActions.add, action] }, returnMode, valueCounter, enableTimestamps, logger);
+        },
+        delete(attr, value) {
+            const attrName = normalizeAttr(attr);
+            const valueName = getUniqueValueName(attrName);
+            const action = {
+                expression: `#${attrName} :${valueName}`,
+                names: { [`#${attrName}`]: attrName },
+                values: { [`:${valueName}`]: value },
+            };
+            return createUpdateBuilder(tableName, key, client, conditions, { ...updateActions, delete: [...updateActions.delete, action] }, returnMode, valueCounter, enableTimestamps, logger);
+        },
+        returning(mode) {
+            return createUpdateBuilder(tableName, key, client, conditions, updateActions, mode, valueCounter, enableTimestamps, logger);
+        },
+        dbParams() {
+            // Build UpdateExpression from actions
+            const updateParts = [];
+            const allNames = {};
+            const allValues = {};
+            // Clone updateActions to avoid mutation
+            const actionsToProcess = { ...updateActions };
+            // Add updatedAt timestamp if enabled
+            if (enableTimestamps) {
+                const now = new Date().toISOString();
+                const timestampAction = {
+                    expression: `#updatedAt = :updatedAt_ts`,
+                    names: { '#updatedAt': 'updatedAt' },
+                    values: { ':updatedAt_ts': now },
+                };
+                actionsToProcess.set = [...actionsToProcess.set, timestampAction];
+            }
+            if (actionsToProcess.set.length > 0) {
+                const setExpressions = actionsToProcess.set.map((action) => {
+                    Object.assign(allNames, action.names || {});
+                    Object.assign(allValues, action.values || {});
+                    return action.expression;
+                });
+                updateParts.push(`SET ${setExpressions.join(', ')}`);
+            }
+            if (updateActions.remove.length > 0) {
+                const removeExpressions = updateActions.remove.map((action) => {
+                    Object.assign(allNames, action.names || {});
+                    return action.expression;
+                });
+                updateParts.push(`REMOVE ${removeExpressions.join(', ')}`);
+            }
+            if (updateActions.add.length > 0) {
+                const addExpressions = updateActions.add.map((action) => {
+                    Object.assign(allNames, action.names || {});
+                    Object.assign(allValues, action.values || {});
+                    return action.expression;
+                });
+                updateParts.push(`ADD ${addExpressions.join(', ')}`);
+            }
+            if (updateActions.delete.length > 0) {
+                const deleteExpressions = updateActions.delete.map((action) => {
+                    Object.assign(allNames, action.names || {});
+                    Object.assign(allValues, action.values || {});
+                    return action.expression;
+                });
+                updateParts.push(`DELETE ${deleteExpressions.join(', ')}`);
+            }
+            const updateExpression = updateParts.join(' ');
+            // Build ConditionExpression from conditions
+            let conditionExpression = '';
+            let conditionNames = {};
+            let conditionValues = {};
+            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;
+                conditionNames = result.names;
+                conditionValues = result.values;
+            }
+            // Merge names and values
+            const expressionAttributeNames = {
+                ...allNames,
+                ...conditionNames,
+            };
+            const expressionAttributeValues = {
+                ...allValues,
+                ...conditionValues,
+            };
+            const extra = returnMode !== 'NONE' ? { ReturnValues: returnMode } : {};
+            return {
+                TableName: tableName,
+                Key: key,
+                ...(updateExpression && { UpdateExpression: updateExpression }),
+                ...(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.UpdateCommand(params));
+            logger?.log('UpdateCommand', params, response);
+            // Return the updated item based on returnMode
+            if (returnMode === 'ALL_NEW' && response.Attributes) {
+                return response.Attributes;
+            }
+            if (returnMode === 'UPDATED_NEW' && response.Attributes) {
+                return response.Attributes;
+            }
+            // For other modes, return the key as a fallback
+            return key;
+        },
+    });
+    return build();
+}

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

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

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

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

package/dist/builders/update/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-update-builder"), exports);

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

@@ -0,0 +1,35 @@
+import { OperationBuilder, AttrRef } from '../shared';
+/**
+ * Update actions that can be performed on attributes
+ */
+export type UpdateAction = {
+    expression: string;
+    names?: Record<string, string>;
+    values?: Record<string, any>;
+};
+/**
+ * Builder interface for DynamoDB UpdateItem operations
+ */
+export interface UpdateBuilder<Model> extends OperationBuilder<Model> {
+    /**
+     * Sets an attribute to a specific value
+     */
+    set(attr: keyof Model | AttrRef, value: any): UpdateBuilder<Model>;
+    /**
+     * Removes an attribute from the item
+     */
+    remove(attr: keyof Model | AttrRef): UpdateBuilder<Model>;
+    /**
+     * Adds a value to a number attribute or adds elements to a set
+     */
+    add(attr: keyof Model | AttrRef, value: any): UpdateBuilder<Model>;
+    /**
+     * Deletes elements from a set attribute
+     */
+    delete(attr: keyof Model | AttrRef, value: any): UpdateBuilder<Model>;
+    /**
+     * Configures what values should be returned after the update operation
+     */
+    returning(mode: 'NONE' | 'ALL_OLD' | 'ALL_NEW' | 'UPDATED_OLD' | 'UPDATED_NEW'): UpdateBuilder<Model>;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/update/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC9B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,KAAK,CAAE,SAAQ,gBAAgB,CAAC,KAAK,CAAC;IACnE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEnE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAE1D;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEnE;;OAEG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,KAAK,GAAG,OAAO,EAAE,KAAK,EAAE,GAAG,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;IAEtE;;OAEG;IACH,SAAS,CACP,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,aAAa,GAAG,aAAa,GACnE,aAAa,CAAC,KAAK,CAAC,CAAC;CACzB"}

package/dist/builders/update/types.js

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