dyno-table 0.1.8 → 0.2.0-0

package/dist/table.d.cts

@@ -0,0 +1,12 @@
+import './types.cjs';
+import './conditions-ChhQWd6z.cjs';
+import './query-builder-D2FM9rsu.cjs';
+import './builders/put-builder.cjs';
+import './builders/delete-builder.cjs';
+import './builders/update-builder.cjs';
+import './builders/transaction-builder.cjs';
+export { T as Table } from './table-BEhBPy2G.cjs';
+import './builders/condition-check-builder.cjs';
+import '@aws-sdk/lib-dynamodb';
+import './builders/paginator.cjs';
+import './builder-types-DtwbqMeF.cjs';

package/dist/table.d.ts

@@ -0,0 +1,12 @@
+import './types.js';
+import './conditions--ld9a78i.js';
+import './query-builder-Csror9Iu.js';
+import './builders/put-builder.js';
+import './builders/delete-builder.js';
+import './builders/update-builder.js';
+import './builders/transaction-builder.js';
+export { T as Table } from './table-BW3cmUqr.js';
+import './builders/condition-check-builder.js';
+import '@aws-sdk/lib-dynamodb';
+import './builders/paginator.js';
+import './builder-types-C_PDZhnP.js';

package/dist/table.js

@@ -861,6 +861,14 @@ var PutBuilder = class {
       returnValues: "NONE"
     };
   }
+  set(valuesOrPath, value) {
+    if (typeof valuesOrPath === "object") {
+      Object.assign(this.item, valuesOrPath);
+    } else {
+      this.item[valuesOrPath] = value;
+    }
+    return this;
+  }
   /**
    * Adds a condition that must be satisfied for the put operation to succeed.
    * Use this method when you need to:
@@ -1105,10 +1113,6 @@ var DeleteBuilder = class {
   }
   /**
    * Adds a condition that must be satisfied for the delete operation to succeed.
-   * Use this method when you need to:
-   * - Ensure safe removal conditions
-   * - Verify habitat status before deletion
-   * - Implement safety protocols
    *
    * @example
    * ```typescript
@@ -1160,10 +1164,6 @@ var DeleteBuilder = class {
   }
   /**
    * Sets whether to return the item's attribute values before deletion.
-   * Use this method when you need to:
-   * - Archive removed dinosaur data
-   * - Track habitat decommissioning history
-   * - Maintain removal audit logs
    *
    * @example
    * ```ts
@@ -1204,10 +1204,6 @@ var DeleteBuilder = class {
   }
   /**
    * Adds this delete operation to a transaction.
-   * Use this method when you need to:
-   * - Coordinate dinosaur transfers
-   * - Manage habitat decommissioning
-   * - Handle species relocations
    *
    * @example
    * ```ts
@@ -1258,11 +1254,6 @@ var DeleteBuilder = class {
   /**
    * Gets a human-readable representation of the delete command
    * with all expression placeholders replaced by their actual values.
-   * Use this method when you need to:
-   * - Debug complex deletion conditions
-   * - Verify safety checks
-   * - Log removal operations
-   * - Troubleshoot failed deletions
    *
    * @example
    * ```ts
@@ -1321,10 +1312,6 @@ var UpdateBuilder = class {
   }
   /**
    * Removes an attribute from the item.
-   * Use this method when you need to:
-   * - Delete attributes completely
-   * - Remove nested attributes
-   * - Clean up deprecated fields
    *
    * @example
    * ```typescript
@@ -1351,10 +1338,6 @@ var UpdateBuilder = class {
   }
   /**
    * Adds a value to a number attribute or adds elements to a set.
-   * Use this method when you need to:
-   * - Increment counters
-   * - Add elements to a set atomically
-   * - Update numerical statistics
    *
    * @example
    * ```typescript
@@ -1383,10 +1366,6 @@ var UpdateBuilder = class {
   }
   /**
    * Removes elements from a set attribute.
-   * Use this method when you need to:
-   * - Remove specific elements from a set
-   * - Update set-based attributes atomically
-   * - Maintain set membership
    *
    * @example
    * ```typescript
@@ -1396,7 +1375,7 @@ var UpdateBuilder = class {
    *   ['JUNGLE', 'COASTAL']
    * );
    *
-   * // Remove from sets using Set objects
+   * // Remove from sets using Set DynamoItems
    * builder.deleteElementsFromSet(
    *   'knownBehaviors',
    *   new Set(['NOCTURNAL', 'TERRITORIAL'])
@@ -1429,11 +1408,6 @@ var UpdateBuilder = class {
   }
   /**
    * Adds a condition that must be satisfied for the update to succeed.
-   * Use this method when you need to:
-   * - Implement optimistic locking
-   * - Ensure item state before update
-   * - Validate business rules
-   * - Prevent concurrent modifications
    *
    * @example
    * ```typescript
@@ -1465,7 +1439,7 @@ var UpdateBuilder = class {
    * );
    * ```
    *
-   * @param condition - Either a Condition object or a callback function that builds the condition
+   * @param condition - Either a Condition DynamoItem or a callback function that builds the condition
    * @returns The builder instance for method chaining
    */
   condition(condition) {
@@ -1494,11 +1468,6 @@ var UpdateBuilder = class {
   }
   /**
    * Sets which item attributes to include in the response.
-   * Use this method when you need to:
-   * - Get the complete updated item
-   * - Track changes to specific attributes
-   * - Compare old and new values
-   * - Monitor attribute modifications
    *
    * Available options:
    * - ALL_NEW: All attributes after the update
@@ -1626,10 +1595,6 @@ var UpdateBuilder = class {
   }
   /**
    * Adds this update operation to a transaction.
-   * Use this method when you need to:
-   * - Update items as part of a larger transaction
-   * - Ensure multiple updates are atomic
-   * - Coordinate updates across multiple items
    *
    * @example
    * ```typescript
@@ -1659,11 +1624,6 @@ var UpdateBuilder = class {
   }
   /**
    * Gets a human-readable representation of the update command.
-   * Use this method when you need to:
-   * - Debug complex update expressions
-   * - Verify attribute names and values
-   * - Log update operations
-   * - Troubleshoot condition expressions
    *
    * @example
    * ```typescript
@@ -1690,10 +1650,6 @@ var UpdateBuilder = class {
   }
   /**
    * Executes the update operation against DynamoDB.
-   * Use this method when you need to:
-   * - Apply updates immediately
-   * - Get the updated item values
-   * - Handle conditional update failures
    *
    * @example
    * ```typescript
@@ -1728,7 +1684,7 @@ var UpdateBuilder = class {
    * }
    * ```
    *
-   * @returns A promise that resolves to an object containing the updated item (if returnValues is set)
+   * @returns A promise that resolves to an DynamoItem containing the updated item (if returnValues is set)
    * @throws {ConditionalCheckFailedException} If the condition check fails
    * @throws {Error} If the update operation fails for other reasons
    */
@@ -1782,7 +1738,7 @@ var TransactionBuilder = class {
    */
   checkForDuplicateItem(tableName, newItem) {
     const pkName = this.indexConfig.partitionKey;
-    const skName = this.indexConfig.sortKey || "";
+    const skName = this.indexConfig.sortKey ?? "";
     const pkValue = newItem[pkName];
     const skValue = skName ? newItem[skName] : void 0;
     if (!pkValue) {
@@ -1823,6 +1779,18 @@ var TransactionBuilder = class {
       );
     }
   }
+  createKeyForPrimaryIndex(key) {
+    const keyCondition = {
+      [this.indexConfig.partitionKey]: key.pk
+    };
+    if (this.indexConfig.sortKey) {
+      if (key.sk === void 0) {
+        throw new Error("Sort key is required for delete operation");
+      }
+      keyCondition[this.indexConfig.sortKey] = key.sk;
+    }
+    return keyCondition;
+  }
   /**
    * Adds a put operation to the transaction.
    * Use this method when you need to:
@@ -1962,15 +1930,13 @@ var TransactionBuilder = class {
    * @throws {Error} If a duplicate item is detected in the transaction
    */
   delete(tableName, key, condition) {
-    this.checkForDuplicateItem(tableName, key);
+    const keyCondition = this.createKeyForPrimaryIndex(key);
+    this.checkForDuplicateItem(tableName, keyCondition);
     const transactionItem = {
       type: "Delete",
       params: {
         tableName,
-        key: {
-          pk: key.pk,
-          sk: key.sk
-        }
+        key: keyCondition
       }
     };
     if (condition) {
@@ -2012,10 +1978,14 @@ var TransactionBuilder = class {
    * @see DeleteBuilder for creating delete commands
    */
   deleteWithCommand(command) {
-    this.checkForDuplicateItem(command.tableName, command.key);
+    const keyCondition = this.createKeyForPrimaryIndex(command.key);
+    this.checkForDuplicateItem(command.tableName, keyCondition);
     const transactionItem = {
       type: "Delete",
-      params: command
+      params: {
+        ...command,
+        key: keyCondition
+      }
     };
     this.items.push(transactionItem);
     return this;
@@ -2075,15 +2045,13 @@ var TransactionBuilder = class {
    * @throws {Error} If a duplicate item is detected in the transaction
    */
   update(tableName, key, updateExpression, expressionAttributeNames, expressionAttributeValues, condition) {
-    this.checkForDuplicateItem(tableName, key);
+    const keyCondition = this.createKeyForPrimaryIndex(key);
+    this.checkForDuplicateItem(tableName, keyCondition);
     const transactionItem = {
       type: "Update",
       params: {
         tableName,
-        key: {
-          pk: key.pk,
-          sk: key.sk
-        },
+        key: keyCondition,
         updateExpression,
         expressionAttributeNames,
         expressionAttributeValues
@@ -2137,10 +2105,14 @@ var TransactionBuilder = class {
    * @see UpdateBuilder for creating update commands
    */
   updateWithCommand(command) {
-    this.checkForDuplicateItem(command.tableName, command.key);
+    const keyCondition = this.createKeyForPrimaryIndex(command.key);
+    this.checkForDuplicateItem(command.tableName, keyCondition);
     const transactionItem = {
       type: "Update",
-      params: command
+      params: {
+        ...command,
+        key: keyCondition
+      }
     };
     this.items.push(transactionItem);
     return this;
@@ -2197,7 +2169,8 @@ var TransactionBuilder = class {
    * @throws {Error} If condition expression generation fails
    */
   conditionCheck(tableName, key, condition) {
-    this.checkForDuplicateItem(tableName, key);
+    const keyCondition = this.createKeyForPrimaryIndex(key);
+    this.checkForDuplicateItem(tableName, keyCondition);
     const { expression, names, values } = prepareExpressionParams(condition);
     if (!expression) {
       throw new Error("Failed to generate condition expression");
@@ -2206,10 +2179,7 @@ var TransactionBuilder = class {
       type: "ConditionCheck",
       params: {
         tableName,
-        key: {
-          pk: key.pk,
-          sk: key.sk
-        },
+        key: keyCondition,
         conditionExpression: expression,
         expressionAttributeNames: names,
         expressionAttributeValues: values
@@ -2249,10 +2219,14 @@ var TransactionBuilder = class {
    * @see ConditionCheckBuilder for creating condition check commands
    */
   conditionCheckWithCommand(command) {
-    this.checkForDuplicateItem(command.tableName, command.key);
+    const keyCondition = this.createKeyForPrimaryIndex(command.key);
+    this.checkForDuplicateItem(command.tableName, keyCondition);
     const transactionItem = {
       type: "ConditionCheck",
-      params: command
+      params: {
+        ...command,
+        key: keyCondition
+      }
     };
     this.items.push(transactionItem);
     return this;
@@ -2485,7 +2459,7 @@ var ConditionCheckBuilder = class {
    * );
    * ```
    *
-   * @param condition - Either a Condition object or a callback function that builds the condition
+   * @param condition - Either a Condition DynamoItem or a callback function that builds the condition
    * @returns The builder instance for method chaining
    */
   condition(condition) {
@@ -2711,18 +2685,18 @@ var GetBuilder = class {
    *          - item: The retrieved dinosaur or undefined if not found
    */
   async execute() {
-    if (this.selectedFields.size > 0) {
-      const expressionAttributeNames = {};
-      const projectionParts = [];
-      for (const path of this.selectedFields) {
-        const attrName = `#attr${projectionParts.length}`;
-        expressionAttributeNames[attrName] = path;
-        projectionParts.push(attrName);
-      }
-      this.params.projectionExpression = projectionParts.join(", ");
-      this.params.expressionAttributeNames = expressionAttributeNames;
-    }
-    return this.executor(this.params);
+    const expressionParams = {
+      expressionAttributeNames: {},
+      expressionAttributeValues: {},
+      valueCounter: { count: 0 }
+    };
+    const projectionExpression = Array.from(this.selectedFields).map((p) => generateAttributeName(expressionParams, p)).join(", ");
+    const { expressionAttributeNames } = expressionParams;
+    return this.executor({
+      ...this.params,
+      projectionExpression: projectionExpression.length > 0 ? projectionExpression : void 0,
+      expressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : void 0
+    });
   }
 };
 
@@ -2817,6 +2791,16 @@ var Table = class {
     this.sortKey = config.indexes.sortKey;
     this.gsis = config.indexes.gsis || {};
   }
+  createKeyForPrimaryIndex(keyCondition) {
+    const primaryCondition = { [this.partitionKey]: keyCondition.pk };
+    if (this.sortKey) {
+      if (!keyCondition.sk) {
+        throw new Error("Sort key has not been provided but the Table has a sort key");
+      }
+      primaryCondition[this.sortKey] = keyCondition.sk;
+    }
+    return primaryCondition;
+  }
   /**
    * Creates a new item in the table, it will fail if the item already exists
    *
@@ -2831,7 +2815,7 @@ var Table = class {
       try {
         const result = await this.dynamoClient.get({
           TableName: params.tableName,
-          Key: params.key,
+          Key: this.createKeyForPrimaryIndex(keyCondition),
           ProjectionExpression: params.projectionExpression,
           ExpressionAttributeNames: params.expressionAttributeNames,
           ConsistentRead: params.consistentRead
@@ -2866,13 +2850,12 @@ var Table = class {
           ReturnValues: params.returnValues === "CONSISTENT" ? "NONE" : params.returnValues
         });
         if (params.returnValues === "CONSISTENT") {
-          const key = {
-            pk: params.item[this.partitionKey],
-            ...this.sortKey && { sk: params.item[this.sortKey] }
-          };
           const getResult = await this.dynamoClient.get({
             TableName: params.tableName,
-            Key: key,
+            Key: this.createKeyForPrimaryIndex({
+              pk: params.item[this.partitionKey],
+              ...this.sortKey && { sk: params.item[this.sortKey] }
+            }),
             ConsistentRead: true
           });
           return getResult.Item;
@@ -3056,7 +3039,7 @@ var Table = class {
       try {
         const result = await this.dynamoClient.delete({
           TableName: params.tableName,
-          Key: params.key,
+          Key: this.createKeyForPrimaryIndex(keyCondition),
           ConditionExpression: params.conditionExpression,
           ExpressionAttributeNames: params.expressionAttributeNames,
           ExpressionAttributeValues: params.expressionAttributeValues,
@@ -3083,7 +3066,7 @@ var Table = class {
       try {
         const result = await this.dynamoClient.update({
           TableName: params.tableName,
-          Key: params.key,
+          Key: this.createKeyForPrimaryIndex(keyCondition),
           UpdateExpression: params.updateExpression,
           ConditionExpression: params.conditionExpression,
           ExpressionAttributeNames: params.expressionAttributeNames,
@@ -3211,10 +3194,7 @@ var Table = class {
         }
         return {
           DeleteRequest: {
-            Key: {
-              [this.partitionKey]: operation.key.pk,
-              ...this.sortKey ? { [this.sortKey]: operation.key.sk } : {}
-            }
+            Key: this.createKeyForPrimaryIndex(operation.key)
           }
         };
       });