dyno-table 2.3.2 → 2.4.0

package/dist/{chunk-XYL43FDX.cjs → chunk-AHF4H42Q.cjs}

@@ -1,18 +1,9 @@
 'use strict';
 
+var chunkELULXDSB_cjs = require('./chunk-ELULXDSB.cjs');
 var chunk7UJJ7JXM_cjs = require('./chunk-7UJJ7JXM.cjs');
 
 // src/builders/batch-builder.ts
-var BatchError = class extends Error {
-  operation;
-  cause;
-  constructor(message, operation, cause) {
-    super(message);
-    this.name = "BatchError";
-    this.operation = operation;
-    this.cause = cause;
-  }
-};
 var BatchBuilder = class {
   constructor(batchWriteExecutor, batchGetExecutor, config) {
     this.batchWriteExecutor = batchWriteExecutor;
@@ -47,10 +38,7 @@ var BatchBuilder = class {
    */
   validateNotEmpty() {
     if (this.isEmpty()) {
-      throw new BatchError(
-        "Cannot execute empty batch. Add operations using entity builders with .withBatch()",
-        "write"
-      );
+      throw chunkELULXDSB_cjs.BatchErrors.batchEmpty("write");
     }
   }
   /**
@@ -141,13 +129,14 @@ var BatchBuilder = class {
             key
           };
         }
-        throw new BatchError(`Unsupported batch item type for write operation: ${item.type}`, "write");
+        throw chunkELULXDSB_cjs.BatchErrors.unsupportedType("write", item);
       });
       return await this.batchWriteExecutor(operations);
     } catch (error) {
-      throw new BatchError(
-        `Failed to execute batch write operations: ${error instanceof Error ? error.message : "Unknown error"}`,
-        "write",
+      if (error instanceof chunkELULXDSB_cjs.BatchError) throw error;
+      throw chunkELULXDSB_cjs.BatchErrors.batchWriteFailed(
+        [],
+        { operationCount: this.writeItems.length },
         error instanceof Error ? error : void 0
       );
     }
@@ -174,13 +163,14 @@ var BatchBuilder = class {
             sk: this.config.sortKey ? tableKey[this.config.sortKey] : void 0
           };
         }
-        throw new BatchError(`Unsupported batch item type for get operation: ${item.type}`, "read");
+        throw chunkELULXDSB_cjs.BatchErrors.unsupportedType("read", item);
       });
       return await this.batchGetExecutor(keys);
     } catch (error) {
-      throw new BatchError(
-        `Failed to execute batch get operations: ${error instanceof Error ? error.message : "Unknown error"}`,
-        "read",
+      if (error instanceof chunkELULXDSB_cjs.BatchError) throw error;
+      throw chunkELULXDSB_cjs.BatchErrors.batchGetFailed(
+        [],
+        { operationCount: this.getItems.length },
         error instanceof Error ? error : void 0
       );
     }
@@ -226,13 +216,16 @@ var BatchBuilder = class {
       try {
         writeResults = await this.executeWrites();
       } catch (error) {
-        if (error instanceof BatchError) {
+        if (error instanceof chunkELULXDSB_cjs.BatchError) {
           errors.push(error);
         } else {
           errors.push(
-            new BatchError(
+            new chunkELULXDSB_cjs.BatchError(
               "Unexpected error during write operations",
+              chunkELULXDSB_cjs.ErrorCodes.BATCH_WRITE_FAILED,
               "write",
+              [],
+              {},
               error instanceof Error ? error : void 0
             )
           );
@@ -243,13 +236,16 @@ var BatchBuilder = class {
       try {
         getResults = await this.executeGets();
       } catch (error) {
-        if (error instanceof BatchError) {
+        if (error instanceof chunkELULXDSB_cjs.BatchError) {
           errors.push(error);
         } else {
           errors.push(
-            new BatchError(
+            new chunkELULXDSB_cjs.BatchError(
               "Unexpected error during read operations",
+              chunkELULXDSB_cjs.ErrorCodes.BATCH_GET_FAILED,
               "read",
+              [],
+              {},
               error instanceof Error ? error : void 0
             )
           );
@@ -316,16 +312,16 @@ var generateValueName = (params, value) => {
 };
 var validateCondition = (condition, requiresAttr = true, requiresValue = true) => {
   if (requiresAttr && !condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   if (requiresValue && condition.value === void 0) {
-    throw new Error(`Value is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingValue(condition.type, condition);
   }
 };
 var buildComparisonExpression = (condition, operator, params) => {
   validateCondition(condition);
   if (!condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   const attrName = generateAttributeName(params, condition.attr);
   const valueName = generateValueName(params, condition.value);
@@ -334,10 +330,14 @@ var buildComparisonExpression = (condition, operator, params) => {
 var buildBetweenExpression = (condition, params) => {
   validateCondition(condition);
   if (!condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   if (!Array.isArray(condition.value) || condition.value.length !== 2) {
-    throw new Error("Between condition requires an array of two values");
+    throw chunkELULXDSB_cjs.ExpressionErrors.invalidCondition(
+      condition.type,
+      condition,
+      "Provide an array with exactly two values: [lowerBound, upperBound]"
+    );
   }
   const attrName = generateAttributeName(params, condition.attr);
   const lowerName = generateValueName(params, condition.value[0]);
@@ -347,13 +347,17 @@ var buildBetweenExpression = (condition, params) => {
 var buildInExpression = (condition, params) => {
   validateCondition(condition);
   if (!condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   if (!Array.isArray(condition.value) || condition.value.length === 0) {
-    throw new Error("In condition requires a non-empty array of values");
+    throw chunkELULXDSB_cjs.ExpressionErrors.emptyArray(condition.type, condition.value);
   }
   if (condition.value.length > 100) {
-    throw new Error("In condition supports a maximum of 100 values");
+    throw chunkELULXDSB_cjs.ExpressionErrors.invalidCondition(
+      condition.type,
+      condition,
+      "Split your query into multiple operations or use a different condition type"
+    );
   }
   const attrName = generateAttributeName(params, condition.attr);
   const valueNames = condition.value.map((value) => generateValueName(params, value));
@@ -362,7 +366,7 @@ var buildInExpression = (condition, params) => {
 var buildFunctionExpression = (functionName, condition, params) => {
   validateCondition(condition);
   if (!condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   const attrName = generateAttributeName(params, condition.attr);
   const valueName = generateValueName(params, condition.value);
@@ -371,66 +375,65 @@ var buildFunctionExpression = (functionName, condition, params) => {
 var buildAttributeFunction = (functionName, condition, params) => {
   validateCondition(condition, true, false);
   if (!condition.attr) {
-    throw new Error(`Attribute is required for ${condition.type} condition`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.missingAttribute(condition.type, condition);
   }
   const attrName = generateAttributeName(params, condition.attr);
   return `${functionName}(${attrName})`;
 };
 var buildLogicalExpression = (operator, conditions, params) => {
   if (!conditions || conditions.length === 0) {
-    throw new Error(`At least one condition is required for ${operator} expression`);
+    throw chunkELULXDSB_cjs.ExpressionErrors.emptyArray(operator, conditions);
   }
   const expressions = conditions.map((c) => buildExpression(c, params));
   return `(${expressions.join(` ${operator} `)})`;
 };
 var buildExpression = (condition, params) => {
   if (!condition) return "";
-  try {
-    const expressionBuilders = {
-      eq: () => buildComparisonExpression(condition, "=", params),
-      ne: () => buildComparisonExpression(condition, "<>", params),
-      lt: () => buildComparisonExpression(condition, "<", params),
-      lte: () => buildComparisonExpression(condition, "<=", params),
-      gt: () => buildComparisonExpression(condition, ">", params),
-      gte: () => buildComparisonExpression(condition, ">=", params),
-      between: () => buildBetweenExpression(condition, params),
-      in: () => buildInExpression(condition, params),
-      beginsWith: () => buildFunctionExpression("begins_with", condition, params),
-      contains: () => buildFunctionExpression("contains", condition, params),
-      attributeExists: () => buildAttributeFunction("attribute_exists", condition, params),
-      attributeNotExists: () => buildAttributeFunction("attribute_not_exists", condition, params),
-      and: () => {
-        if (!condition.conditions) {
-          throw new Error("Conditions array is required for AND operator");
-        }
-        return buildLogicalExpression("AND", condition.conditions, params);
-      },
-      or: () => {
-        if (!condition.conditions) {
-          throw new Error("Conditions array is required for OR operator");
-        }
-        return buildLogicalExpression("OR", condition.conditions, params);
-      },
-      not: () => {
-        if (!condition.condition) {
-          throw new Error("Condition is required for NOT operator");
-        }
-        return `NOT (${buildExpression(condition.condition, params)})`;
+  const expressionBuilders = {
+    eq: () => buildComparisonExpression(condition, "=", params),
+    ne: () => buildComparisonExpression(condition, "<>", params),
+    lt: () => buildComparisonExpression(condition, "<", params),
+    lte: () => buildComparisonExpression(condition, "<=", params),
+    gt: () => buildComparisonExpression(condition, ">", params),
+    gte: () => buildComparisonExpression(condition, ">=", params),
+    between: () => buildBetweenExpression(condition, params),
+    in: () => buildInExpression(condition, params),
+    beginsWith: () => buildFunctionExpression("begins_with", condition, params),
+    contains: () => buildFunctionExpression("contains", condition, params),
+    attributeExists: () => buildAttributeFunction("attribute_exists", condition, params),
+    attributeNotExists: () => buildAttributeFunction("attribute_not_exists", condition, params),
+    and: () => {
+      if (!condition.conditions) {
+        throw chunkELULXDSB_cjs.ExpressionErrors.invalidCondition(
+          condition.type,
+          condition,
+          "Provide an array of conditions to combine with AND"
+        );
       }
-    };
-    const builder = expressionBuilders[condition.type];
-    if (!builder) {
-      throw new Error(`Unknown condition type: ${condition.type}`);
-    }
-    return builder();
-  } catch (error) {
-    if (error instanceof Error) {
-      console.error(`Error building expression for condition type ${condition.type}:`, error.message);
-    } else {
-      console.error(`Error building expression for condition type ${condition.type}:`, error);
+      return buildLogicalExpression("AND", condition.conditions, params);
+    },
+    or: () => {
+      if (!condition.conditions) {
+        throw chunkELULXDSB_cjs.ExpressionErrors.invalidCondition(
+          condition.type,
+          condition,
+          "Provide an array of conditions to combine with OR"
+        );
+      }
+      return buildLogicalExpression("OR", condition.conditions, params);
+    },
+    not: () => {
+      if (!condition.condition) {
+        throw chunkELULXDSB_cjs.ExpressionErrors.invalidCondition(condition.type, condition, "Provide a condition to negate with NOT");
+      }
+      return `NOT (${buildExpression(condition.condition, params)})`;
     }
-    throw error;
+  };
+  const builder = expressionBuilders[condition.type];
+  if (!builder) {
+    throw chunkELULXDSB_cjs.ExpressionErrors.unknownType(condition.type, condition);
   }
+  return builder();
 };
 var prepareExpressionParams = (condition) => {
   if (!condition) return {};
@@ -1757,7 +1760,7 @@ var TransactionBuilder = class {
     const pkValue = newItem[pkName];
     const skValue = skName ? newItem[skName] : void 0;
     if (!pkValue) {
-      throw new Error(`Primary key value for '${pkName}' is missing`);
+      throw chunkELULXDSB_cjs.ConfigurationErrors.primaryKeyMissing(tableName, pkName, newItem);
     }
     const duplicateItem = this.items.find((item) => {
       let itemKey;
@@ -1789,8 +1792,10 @@ var TransactionBuilder = class {
       return false;
     });
     if (duplicateItem) {
-      throw new Error(
-        `Duplicate item detected in transaction: Table=${tableName}, ${pkName}=${String(pkValue)}, ${skName}=${skValue !== void 0 ? String(skValue) : "undefined"}. DynamoDB transactions do not allow multiple operations on the same item.`
+      throw chunkELULXDSB_cjs.TransactionErrors.duplicateItem(
+        tableName,
+        { name: pkName, value: pkValue },
+        skName ? { name: skName, value: skValue } : void 0
       );
     }
   }
@@ -1800,7 +1805,7 @@ var TransactionBuilder = class {
     };
     if (this.indexConfig.sortKey) {
       if (key.sk === void 0) {
-        throw new Error("Sort key is required for delete operation");
+        throw chunkELULXDSB_cjs.ConfigurationErrors.sortKeyRequired("", this.indexConfig.partitionKey, this.indexConfig.sortKey);
       }
       keyCondition[this.indexConfig.sortKey] = key.sk;
     }
@@ -2174,7 +2179,7 @@ var TransactionBuilder = class {
     this.checkForDuplicateItem(tableName, keyCondition);
     const { expression, names, values } = prepareExpressionParams(condition);
     if (!expression) {
-      throw new Error("Failed to generate condition expression");
+      throw chunkELULXDSB_cjs.ConfigurationErrors.conditionGenerationFailed(condition);
     }
     const transactionItem = {
       type: "ConditionCheck",
@@ -2328,7 +2333,7 @@ var TransactionBuilder = class {
    */
   async execute() {
     if (this.items.length === 0) {
-      throw new Error("No transaction items specified");
+      throw chunkELULXDSB_cjs.TransactionErrors.transactionEmpty();
     }
     const transactItems = this.items.map((item) => {
       switch (item.type) {
@@ -2375,7 +2380,7 @@ var TransactionBuilder = class {
           };
         default: {
           const exhaustiveCheck = item;
-          throw new Error(`Unsupported transaction item type: ${String(exhaustiveCheck)}`);
+          throw chunkELULXDSB_cjs.TransactionErrors.unsupportedType(exhaustiveCheck);
         }
       }
     });
@@ -2388,9 +2393,7 @@ var TransactionBuilder = class {
     try {
       await this.executor(params);
     } catch (error) {
-      console.log(this.debug());
-      console.error("Error executing transaction:", error);
-      throw error;
+      throw chunkELULXDSB_cjs.TransactionErrors.transactionFailed(this.items.length, {}, error instanceof Error ? error : void 0);
     }
   }
 };
@@ -2412,6 +2415,9 @@ var UpdateBuilder = class {
   set(valuesOrPath, value) {
     if (typeof valuesOrPath === "object") {
       for (const [key, value2] of Object.entries(valuesOrPath)) {
+        if (value2 === void 0) {
+          throw chunkELULXDSB_cjs.ValidationErrors.undefinedValue(key, this.tableName, this.key);
+        }
         this.updates.push({
           type: "SET",
           path: key,
@@ -2419,6 +2425,9 @@ var UpdateBuilder = class {
         });
       }
     } else {
+      if (value === void 0) {
+        throw chunkELULXDSB_cjs.ValidationErrors.undefinedValue(valuesOrPath, this.tableName, this.key);
+      }
       this.updates.push({
         type: "SET",
         path: valuesOrPath,
@@ -2474,6 +2483,9 @@ var UpdateBuilder = class {
    * @returns The builder instance for method chaining
    */
   add(path, value) {
+    if (value === void 0) {
+      throw chunkELULXDSB_cjs.ValidationErrors.undefinedValue(path, this.tableName, this.key);
+    }
     this.updates.push({
       type: "ADD",
       path,
@@ -2510,6 +2522,9 @@ var UpdateBuilder = class {
    * @returns The builder instance for method chaining
    */
   deleteElementsFromSet(path, value) {
+    if (value === void 0) {
+      throw chunkELULXDSB_cjs.ValidationErrors.undefinedValue(path, this.tableName, this.key);
+    }
     let valuesToDelete;
     if (Array.isArray(value)) {
       valuesToDelete = new Set(value);
@@ -2628,7 +2643,7 @@ var UpdateBuilder = class {
    */
   toDynamoCommand() {
     if (this.updates.length === 0) {
-      throw new Error("No update actions specified");
+      throw chunkELULXDSB_cjs.ValidationErrors.noUpdateActions(this.tableName, this.key);
     }
     const expressionParams = {
       expressionAttributeNames: {},
@@ -2902,11 +2917,11 @@ var ConditionCheckBuilder = class {
    */
   toDynamoCommand() {
     if (!this.conditionExpression) {
-      throw new Error("Condition is required for condition check operations");
+      throw chunkELULXDSB_cjs.ValidationErrors.conditionRequired(this.tableName, this.key);
     }
     const { expression, names, values } = prepareExpressionParams(this.conditionExpression);
     if (!expression) {
-      throw new Error("Failed to generate condition expression");
+      throw chunkELULXDSB_cjs.ConfigurationErrors.conditionGenerationFailed(this.conditionExpression);
     }
     return {
       tableName: this.tableName,
@@ -2938,7 +2953,7 @@ var ConditionCheckBuilder = class {
    */
   withTransaction(transaction) {
     if (!this.conditionExpression) {
-      throw new Error("Condition is required for condition check operations");
+      throw chunkELULXDSB_cjs.ValidationErrors.conditionRequired(this.tableName, this.key);
     }
     const command = this.toDynamoCommand();
     transaction.conditionCheckWithCommand(command);
@@ -3200,7 +3215,6 @@ var ScanBuilder = class _ScanBuilder extends FilterBuilder {
 };
 
 exports.BatchBuilder = BatchBuilder;
-exports.BatchError = BatchError;
 exports.ConditionCheckBuilder = ConditionCheckBuilder;
 exports.DeleteBuilder = DeleteBuilder;
 exports.FilterBuilder = FilterBuilder;
@@ -3213,5 +3227,4 @@ exports.ScanBuilder = ScanBuilder;
 exports.TransactionBuilder = TransactionBuilder;
 exports.UpdateBuilder = UpdateBuilder;
 exports.buildExpression = buildExpression;
-exports.debugCommand = debugCommand;
 exports.generateAttributeName = generateAttributeName;