@encodeagent/platform-helper-data 1.2510.1231638 → 1.2511.1011152

package/dist/cosmosdb/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview Azure Cosmos DB implementation
  */
-import { IConnectionForServiceProps, IConnectionResult, IRetrieveResult, ICreateResult, ICreateProps, IRetrieveProps, IQueryProps, IQueryResult } from '../util';
+import { IConnectionForServiceProps, IConnectionResult, IRetrieveResult, IRetrieveProps, ICreateProps, ICreateResult, IQueryProps, IQueryResult, IUpsertProps, IUpsertResult, IUpdateProps, IUpdateResult } from '../util';
 /**
  * Create Azure Cosmos DB connection
  * @param props Connection properties with URI and key
@@ -16,4 +16,11 @@ export declare function connect(props: IConnectionForServiceProps): Promise<ICon
 export declare function retrieve(props: IRetrieveProps): Promise<IRetrieveResult>;
 export declare function query(props: IQueryProps): Promise<IQueryResult>;
 export declare function create(props: ICreateProps): Promise<ICreateResult>;
+/**
+ * Upsert (create or update) a document in Azure Cosmos DB
+ * @param props Upsert properties with client, databaseId, containerId, record, and optional partitionKey
+ * @returns Promise<IUpsertResult>
+ */
+export declare function upsert(props: IUpsertProps): Promise<IUpsertResult>;
+export declare function update(props: IUpdateProps): Promise<IUpdateResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/cosmosdb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cosmosdb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,eAAe,EAAE,aAAa,EAAE,YAAY,EAAE,cAAc,EAAgB,WAAW,EAAE,YAAY,EAA2B,MAAM,SAAS,CAAC;AAMxM;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAgC3F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAgD9E;AAGD,wBAAsB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CA+CrE;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAkCxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cosmosdb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACH,0BAA0B,EAAE,iBAAiB,EAC7C,eAAe,EAAE,cAAc,EAC/B,YAAY,EAAE,aAAa,EAC3B,WAAW,EAAE,YAAY,EACzB,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,aAAa,EAG9B,MAAM,SAAS,CAAC;AAWjB;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8C3F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAuD9E;AAGD,wBAAsB,KAAK,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,CAAC,CAsDrE;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAyCxE;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAkDxE;AAGD,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAsDxE"}

package/dist/cosmosdb/index.js

@@ -7,11 +7,17 @@ exports.connect = connect;
 exports.retrieve = retrieve;
 exports.query = query;
 exports.create = create;
-const platform_helper_util_1 = require("@encodeagent/platform-helper-util");
+exports.upsert = upsert;
+exports.update = update;
 const util_1 = require("../util");
+const platform_helper_util_1 = require("@encodeagent/platform-helper-util");
 const cosmos_1 = require("@azure/cosmos");
 const query_builder_1 = require("./query-builder");
 const ENGINE = "cosmosdb";
+const ERROR_INFO = {
+    package: util_1.PACKAGE,
+    module: "database-cosmosdb"
+};
 /**
  * Create Azure Cosmos DB connection
  * @param props Connection properties with URI and key
@@ -23,13 +29,23 @@ async function connect(props) {
         if (!uri) {
             return {
                 engine: ENGINE,
-                error: 'Azure Cosmos DB URI is required'
+                error: {
+                    ...ERROR_INFO,
+                    source: "connect",
+                    code: "require-db-uri",
+                    message: "Azure Cosmos DB URI is required"
+                }
             };
         }
         if (!key) {
             return {
                 engine: ENGINE,
-                error: 'Azure Cosmos DB key is required'
+                error: {
+                    ...ERROR_INFO,
+                    source: "connect",
+                    code: "require-db-key",
+                    message: "Azure Cosmos DB key is required"
+                }
             };
         }
         // Create Azure Cosmos DB client
@@ -42,7 +58,12 @@ async function connect(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to connect to Azure Cosmos DB'
+            error: {
+                ...ERROR_INFO,
+                source: "connect",
+                code: "database-connect",
+                message: error instanceof Error ? error.message : 'Failed to connect to Azure Cosmos DB'
+            }
         };
     }
 }
@@ -55,6 +76,8 @@ async function retrieve(props) {
     try {
         const { client, id, partitionKey, databaseId, containerId } = props;
         const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
             databaseId,
             containerId,
             checkDatabaseId: true,
@@ -91,7 +114,12 @@ async function retrieve(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to retrieve document from Cosmos DB'
+            error: {
+                ...ERROR_INFO,
+                source: "retrieve",
+                code: "database-retrieve",
+                message: error instanceof Error ? error.message : 'Failed to retrieve document from Cosmos DB'
+            }
         };
     }
 }
@@ -100,6 +128,8 @@ async function query(props) {
     const { client, databaseId, containerId, query } = props;
     try {
         const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
             databaseId,
             containerId,
             checkDatabaseId: true,
@@ -130,7 +160,12 @@ async function query(props) {
             engine: ENGINE,
             query,
             dbQuery,
-            error: error instanceof Error ? error.message : 'Failed to query documents from Cosmos DB'
+            error: {
+                ...ERROR_INFO,
+                source: "query",
+                code: "database-query",
+                message: error instanceof Error ? error.message : 'Failed to query documents from Cosmos DB'
+            }
         };
     }
 }
@@ -138,6 +173,8 @@ async function create(props) {
     try {
         const { client, databaseId, containerId, record } = props;
         const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
             databaseId,
             containerId,
             checkDatabaseId: true,
@@ -160,7 +197,109 @@ async function create(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to create record in Cosmos DB'
+            error: {
+                ...ERROR_INFO,
+                source: "create",
+                code: "database-create",
+                message: error instanceof Error ? error.message : 'Failed to create record in Cosmos DB'
+            }
+        };
+    }
+}
+/**
+ * Upsert (create or update) a document in Azure Cosmos DB
+ * @param props Upsert properties with client, databaseId, containerId, record, and optional partitionKey
+ * @returns Promise<IUpsertResult>
+ */
+async function upsert(props) {
+    try {
+        const { client, databaseId, containerId, record } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            databaseId,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
+        const database = client.database(databaseId);
+        const container = database.container(containerId);
+        // Ensure the record has an id
+        const recordWithId = {
+            ...record,
+            id: record.id ?? (0, platform_helper_util_1.newGuid)()
+        };
+        // Use upsert operation which creates if not exists or replaces if exists
+        const response = await container.items.upsert(recordWithId);
+        // Check if this was a new document or an update
+        // Cosmos DB doesn't directly tell us, but we can infer from the response
+        const isNew = response.statusCode === 201;
+        return {
+            engine: ENGINE,
+            data: response.resource,
+            isNew
+        };
+    }
+    catch (error) {
+        return {
+            engine: ENGINE,
+            error: {
+                ...ERROR_INFO,
+                source: "upsert",
+                code: "database-upsert",
+                message: error instanceof Error ? error.message : 'Failed to upsert record in Cosmos DB'
+            }
+        };
+    }
+}
+async function update(props) {
+    try {
+        const { client, databaseId, containerId, record, partitionKey } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            databaseId,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
+        if (!record?.id || !(0, platform_helper_util_1.isNonEmptyString)(String(record.id))) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "update",
+                    code: "require-record-id",
+                    message: "Record id is required for update"
+                }
+            };
+        }
+        const database = client.database(databaseId);
+        const container = database.container(containerId);
+        const item = (0, platform_helper_util_1.isNonEmptyString)(partitionKey)
+            ? container.item(record.id, partitionKey)
+            : container.item(record.id);
+        const response = await item.replace(record);
+        return {
+            engine: ENGINE,
+            data: response.resource
+        };
+    }
+    catch (error) {
+        return {
+            engine: ENGINE,
+            error: {
+                ...ERROR_INFO,
+                source: "update",
+                code: "database-update",
+                message: error instanceof Error ? error.message : 'Failed to update record in Cosmos DB'
+            }
         };
     }
 }

package/dist/cosmosdb/index.js.map

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

package/dist/dynamodb/index.d.ts

@@ -1,7 +1,7 @@
 /**
  * @fileoverview AWS DynamoDB implementation
  */
-import { IConnectionForServiceProps, IConnectionResult, IRetrieveResult, IRetrieveProps, ICreateProps } from '../util';
+import { IConnectionForServiceProps, IConnectionResult, IRetrieveResult, IRetrieveProps, ICreateProps, ICreateResult, IUpsertProps, IUpsertResult, IUpdateProps, IUpdateResult } from '../util';
 /**
  * Create AWS DynamoDB connection
  * @param props Connection properties with URI and key
@@ -11,8 +11,15 @@ export declare function connect(props: IConnectionForServiceProps): Promise<ICon
 /**
  * Retrieve document by ID from AWS DynamoDB
  * @param props Retrieve properties with client, collection (table), and id
- * @returns Promise<IRetrieveResult<T>>
+ * @returns Promise<IRetrieveResult>
  */
-export declare function retrieve<T>(props: IRetrieveProps): Promise<IRetrieveResult<T>>;
-export declare function create<T>(props: ICreateProps): Promise<IRetrieveResult<T>>;
+export declare function retrieve(props: IRetrieveProps): Promise<IRetrieveResult>;
+export declare function create(props: ICreateProps): Promise<ICreateResult>;
+/**
+ * Upsert (create or update) a document in AWS DynamoDB
+ * @param props Upsert properties with client, containerId (table name), and record
+ * @returns Promise<IUpsertResult>
+ */
+export declare function upsert(props: IUpsertProps): Promise<IUpsertResult>;
+export declare function update(props: IUpdateProps): Promise<IUpdateResult>;
 //# sourceMappingURL=index.d.ts.map

package/dist/dynamodb/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dynamodb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,iBAAiB,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAiB,MAAM,SAAS,CAAC;AAOtI;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAmD3F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAkCpF;AAED,wBAAsB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAyChF"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/dynamodb/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEH,0BAA0B,EAAE,iBAAiB,EAC7C,eAAe,EAAE,cAAc,EAC/B,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,aAAa,EAC9B,MAAM,SAAS,CAAC;AAYjB;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,KAAK,EAAE,0BAA0B,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAuE3F;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC,CAmD9E;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAqExE;AAED;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CAoFxE;AAED,wBAAsB,MAAM,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC,CA4GxE"}

package/dist/dynamodb/index.js

@@ -6,10 +6,18 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.connect = connect;
 exports.retrieve = retrieve;
 exports.create = create;
+exports.upsert = upsert;
+exports.update = update;
+const util_1 = require("../util");
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const util_dynamodb_1 = require("@aws-sdk/util-dynamodb");
 const platform_helper_util_1 = require("@encodeagent/platform-helper-util");
+const util_2 = require("../util");
 const ENGINE = "dynamodb";
+const ERROR_INFO = {
+    package: util_2.PACKAGE,
+    module: "database-dynamodb"
+};
 /**
  * Create AWS DynamoDB connection
  * @param props Connection properties with URI and key
@@ -20,14 +28,24 @@ async function connect(props) {
         const { uri, key } = props;
         if (!uri) {
             return {
-                engine: "dynamodb",
-                error: 'AWS DynamoDB URI is required'
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "connect",
+                    code: "require-db-uri",
+                    message: "AWS DynamoDB URI is required"
+                }
             };
         }
         if (!key) {
             return {
                 engine: ENGINE,
-                error: 'AWS DynamoDB access key is required'
+                error: {
+                    ...ERROR_INFO,
+                    source: "connect",
+                    code: "require-db-key",
+                    message: "AWS DynamoDB access key is required"
+                }
             };
         }
         // Parse AWS credentials from key (format: accessKeyId:secretAccessKey)
@@ -35,7 +53,12 @@ async function connect(props) {
         if (!accessKeyId || !secretAccessKey) {
             return {
                 engine: ENGINE,
-                error: 'AWS key must be in format: accessKeyId:secretAccessKey'
+                error: {
+                    ...ERROR_INFO,
+                    source: "connect",
+                    code: "invalid-db-key",
+                    message: "AWS key must be in format: accessKeyId:secretAccessKey"
+                }
             };
         }
         // Create DynamoDB client configuration
@@ -56,18 +79,34 @@ async function connect(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to connect to AWS DynamoDB'
+            error: {
+                ...ERROR_INFO,
+                source: "connect",
+                code: "database-connect",
+                message: error instanceof Error ? error.message : 'Failed to connect to AWS DynamoDB'
+            }
         };
     }
 }
 /**
  * Retrieve document by ID from AWS DynamoDB
  * @param props Retrieve properties with client, collection (table), and id
- * @returns Promise<IRetrieveResult<T>>
+ * @returns Promise<IRetrieveResult>
  */
 async function retrieve(props) {
     try {
-        const { client, id, containerId } = props;
+        const { client, id, containerId, databaseId } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            databaseId,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
         // Create GetItem command
         const command = new client_dynamodb_1.GetItemCommand({
             TableName: containerId,
@@ -77,8 +116,7 @@ async function retrieve(props) {
         const response = await client.send(command);
         if (!response.Item) {
             return {
-                engine: ENGINE,
-                error: `Document with ID '${id}' not found in table '${containerId}'`
+                engine: ENGINE
             };
         }
         // Unmarshall the DynamoDB item to regular object
@@ -91,23 +129,49 @@ async function retrieve(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to retrieve document from DynamoDB'
+            error: {
+                ...ERROR_INFO,
+                source: "retrieve",
+                code: "database-retrieve",
+                message: error instanceof Error ? error.message : 'Failed to retrieve document from DynamoDB'
+            }
         };
     }
 }
 async function create(props) {
     try {
-        const { client, containerId, record } = props;
+        const { client, containerId, record, databaseId } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            databaseId,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
         if (!containerId) {
             return {
                 engine: ENGINE,
-                error: 'The containerId (table name) is required'
+                error: {
+                    ...ERROR_INFO,
+                    source: "create",
+                    code: "require-container-id",
+                    message: "The containerId (table name) is required"
+                }
             };
         }
         if (!record) {
             return {
                 engine: ENGINE,
-                error: 'The record is required'
+                error: {
+                    ...ERROR_INFO,
+                    source: "create",
+                    code: "require-record",
+                    message: "The record is required"
+                }
             };
         }
         const item = {
@@ -127,7 +191,189 @@ async function create(props) {
     catch (error) {
         return {
             engine: ENGINE,
-            error: error instanceof Error ? error.message : 'Failed to create record in DynamoDB'
+            error: {
+                ...ERROR_INFO,
+                source: "create",
+                code: "database-create",
+                message: error instanceof Error ? error.message : 'Failed to create record in DynamoDB'
+            }
+        };
+    }
+}
+/**
+ * Upsert (create or update) a document in AWS DynamoDB
+ * @param props Upsert properties with client, containerId (table name), and record
+ * @returns Promise<IUpsertResult>
+ */
+async function upsert(props) {
+    try {
+        const { client, containerId, record, databaseId } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            databaseId,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
+        if (!containerId) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "upsert",
+                    code: "require-container-id",
+                    message: "The containerId (table name) is required"
+                }
+            };
+        }
+        if (!record) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "upsert",
+                    code: "require-record",
+                    message: "The record is required"
+                }
+            };
+        }
+        // Ensure the record has an id
+        const recordWithId = {
+            ...record,
+            id: record.id ?? (0, platform_helper_util_1.newGuid)()
+        };
+        // Check if the item exists to determine if this is a new record
+        let isNew = true;
+        if (record.id) {
+            const getCommand = new client_dynamodb_1.GetItemCommand({
+                TableName: containerId,
+                Key: (0, util_dynamodb_1.marshall)({ id: record.id })
+            });
+            const getResponse = await client.send(getCommand);
+            isNew = !getResponse.Item;
+        }
+        // Use PutItem which will create or replace the item
+        const putCommand = new client_dynamodb_1.PutItemCommand({
+            TableName: containerId,
+            Item: (0, util_dynamodb_1.marshall)(recordWithId)
+        });
+        await client.send(putCommand);
+        return {
+            engine: ENGINE,
+            data: recordWithId,
+            isNew
+        };
+    }
+    catch (error) {
+        return {
+            engine: ENGINE,
+            error: {
+                ...ERROR_INFO,
+                source: "upsert",
+                code: "database-upsert",
+                message: error instanceof Error ? error.message : 'Failed to upsert record in DynamoDB'
+            }
+        };
+    }
+}
+async function update(props) {
+    try {
+        const { client, containerId, record } = props;
+        const errorResult = (0, util_1.validateDatabaseSetting)({
+            engine: ENGINE,
+            ...ERROR_INFO,
+            containerId,
+            checkDatabaseId: true,
+            checkContainerId: true
+        });
+        if (errorResult) {
+            return errorResult;
+        }
+        if (!containerId) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "update",
+                    code: "require-container-id",
+                    message: "The containerId (table name) is required"
+                }
+            };
+        }
+        if (!record) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "update",
+                    code: "require-record",
+                    message: "The record is required"
+                }
+            };
+        }
+        const id = record.id;
+        if (!id) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "update",
+                    code: "require-record-id",
+                    message: "The record.id is required for update"
+                }
+            };
+        }
+        const entries = Object.entries(record).filter(([k]) => k !== 'id');
+        if (entries.length === 0) {
+            return {
+                engine: ENGINE,
+                error: {
+                    ...ERROR_INFO,
+                    source: "update",
+                    code: "no-update-fields",
+                    message: "No fields to update"
+                }
+            };
+        }
+        const ExpressionAttributeNames = {};
+        const ExpressionAttributeValues = {};
+        const assignments = [];
+        entries.forEach(([key, value], idx) => {
+            const nameKey = `#n${idx}`;
+            const valueKey = `:v${idx}`;
+            ExpressionAttributeNames[nameKey] = key;
+            ExpressionAttributeValues[valueKey] = value;
+            assignments.push(`${nameKey} = ${valueKey}`);
+        });
+        const UpdateExpression = `SET ${assignments.join(', ')}`;
+        const command = new client_dynamodb_1.UpdateItemCommand({
+            TableName: containerId,
+            Key: (0, util_dynamodb_1.marshall)({ id }),
+            UpdateExpression,
+            ExpressionAttributeNames,
+            ExpressionAttributeValues: (0, util_dynamodb_1.marshall)(ExpressionAttributeValues),
+            ReturnValues: 'ALL_NEW'
+        });
+        const resp = await client.send(command);
+        const data = resp.Attributes ? ((0, util_dynamodb_1.unmarshall)(resp.Attributes)) : (record);
+        return {
+            engine: ENGINE,
+            data
+        };
+    }
+    catch (error) {
+        return {
+            engine: ENGINE,
+            error: {
+                ...ERROR_INFO,
+                source: "update",
+                code: "database-update",
+                message: error instanceof Error ? error.message : 'Failed to update record in DynamoDB'
+            }
         };
     }
 }