dyno-table 2.4.0 → 2.5.1

package/dist/builders.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkAHF4H42Q_cjs = require('./chunk-AHF4H42Q.cjs');
+var chunk3DR6VOFW_cjs = require('./chunk-3DR6VOFW.cjs');
 require('./chunk-ELULXDSB.cjs');
 require('./chunk-7UJJ7JXM.cjs');
 
@@ -8,49 +8,49 @@ require('./chunk-7UJJ7JXM.cjs');
 
 Object.defineProperty(exports, "BatchBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.BatchBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.BatchBuilder; }
 });
 Object.defineProperty(exports, "ConditionCheckBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.ConditionCheckBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.ConditionCheckBuilder; }
 });
 Object.defineProperty(exports, "DeleteBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.DeleteBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.DeleteBuilder; }
 });
 Object.defineProperty(exports, "FilterBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.FilterBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.FilterBuilder; }
 });
 Object.defineProperty(exports, "GetBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.GetBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.GetBuilder; }
 });
 Object.defineProperty(exports, "Paginator", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.Paginator; }
+  get: function () { return chunk3DR6VOFW_cjs.Paginator; }
 });
 Object.defineProperty(exports, "PutBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.PutBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.PutBuilder; }
 });
 Object.defineProperty(exports, "QueryBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.QueryBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.QueryBuilder; }
 });
 Object.defineProperty(exports, "ResultIterator", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.ResultIterator; }
+  get: function () { return chunk3DR6VOFW_cjs.ResultIterator; }
 });
 Object.defineProperty(exports, "ScanBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.ScanBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.ScanBuilder; }
 });
 Object.defineProperty(exports, "TransactionBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.TransactionBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.TransactionBuilder; }
 });
 Object.defineProperty(exports, "UpdateBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.UpdateBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.UpdateBuilder; }
 });

package/dist/builders.d.cts

@@ -1,4 +1,4 @@
-export { u as BaseBuilderInterface, B as BatchBuilder, C as ConditionCheckBuilder, t as ConditionCheckCommandParams, D as DeleteBuilder, r as DeleteCommandParams, F as FilterBuilder, x as FilterBuilderInterface, G as GetBuilder, y as PaginationResult, q as Paginator, P as PutBuilder, s as PutCommandParams, Q as QueryBuilder, v as QueryBuilderInterface, R as ResultIterator, S as ScanBuilder, w as ScanBuilderInterface, T as TransactionBuilder, z as TransactionItem, U as UpdateBuilder, p as UpdateCommandParams } from './index-BX-MSZHj.cjs';
+export { q as BaseBuilderInterface, B as BatchBuilder, C as ConditionCheckBuilder, r as ConditionCheckCommandParams, D as DeleteBuilder, s as DeleteCommandParams, F as FilterBuilder, t as FilterBuilderInterface, G as GetBuilder, u as PaginationResult, v as Paginator, P as PutBuilder, w as PutCommandParams, Q as QueryBuilder, x as QueryBuilderInterface, R as ResultIterator, S as ScanBuilder, y as ScanBuilderInterface, T as TransactionBuilder, z as TransactionItem, U as UpdateBuilder, p as UpdateCommandParams } from './index-CPCmWsEv.cjs';
 export { s as Path, t as PathType } from './conditions-C8bM__Pn.cjs';
 import './types.cjs';
 import '@aws-sdk/lib-dynamodb';

package/dist/builders.d.ts

@@ -1,4 +1,4 @@
-export { u as BaseBuilderInterface, B as BatchBuilder, C as ConditionCheckBuilder, t as ConditionCheckCommandParams, D as DeleteBuilder, r as DeleteCommandParams, F as FilterBuilder, x as FilterBuilderInterface, G as GetBuilder, y as PaginationResult, q as Paginator, P as PutBuilder, s as PutCommandParams, Q as QueryBuilder, v as QueryBuilderInterface, R as ResultIterator, S as ScanBuilder, w as ScanBuilderInterface, T as TransactionBuilder, z as TransactionItem, U as UpdateBuilder, p as UpdateCommandParams } from './index-DdTolMJW.js';
+export { q as BaseBuilderInterface, B as BatchBuilder, C as ConditionCheckBuilder, r as ConditionCheckCommandParams, D as DeleteBuilder, s as DeleteCommandParams, F as FilterBuilder, t as FilterBuilderInterface, G as GetBuilder, u as PaginationResult, v as Paginator, P as PutBuilder, w as PutCommandParams, Q as QueryBuilder, x as QueryBuilderInterface, R as ResultIterator, S as ScanBuilder, y as ScanBuilderInterface, T as TransactionBuilder, z as TransactionItem, U as UpdateBuilder, p as UpdateCommandParams } from './index-Bc-ra0im.js';
 export { s as Path, t as PathType } from './conditions-BSAcZswY.js';
 import './types.js';
 import '@aws-sdk/lib-dynamodb';

package/dist/builders.js

@@ -1,3 +1,3 @@
-export { BatchBuilder, ConditionCheckBuilder, DeleteBuilder, FilterBuilder, GetBuilder, Paginator, PutBuilder, QueryBuilder, ResultIterator, ScanBuilder, TransactionBuilder, UpdateBuilder } from './chunk-GWHGUKAL.js';
+export { BatchBuilder, ConditionCheckBuilder, DeleteBuilder, FilterBuilder, GetBuilder, Paginator, PutBuilder, QueryBuilder, ResultIterator, ScanBuilder, TransactionBuilder, UpdateBuilder } from './chunk-NYJGW3XH.js';
 import './chunk-FF7FYGDH.js';
 import './chunk-2WIBY7PZ.js';

package/dist/{chunk-AHF4H42Q.cjs → chunk-3DR6VOFW.cjs}

@@ -1467,6 +1467,32 @@ var FilterBuilder = class {
     this.options.lastEvaluatedKey = lastEvaluatedKey;
     return this;
   }
+  /**
+   * Executes the operation and returns the first matching item, if any.
+   *
+   * This helper:
+   * - Applies an internal limit of 1
+   * - Streams results until a match is found or there are no more pages
+   * - Avoids mutating the current builder by using a clone
+   *
+   * @example
+   * ```typescript
+   * const latest = await table
+   *   .query(eq("moduleId", moduleId))
+   *   .useIndex("module-version-index")
+   *   .sortDescending()
+   *   .findOne();
+   * ```
+   *
+   * @returns The first matching item, or undefined if none found
+   */
+  async findOne() {
+    const iterator = await this.clone().limit(1).execute();
+    for await (const item of iterator) {
+      return item;
+    }
+    return void 0;
+  }
 };
 
 // src/builders/result-iterator.ts
@@ -1540,10 +1566,13 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
   keyCondition;
   options = {};
   executor;
-  constructor(executor, keyCondition) {
+  includeIndexAttributes = false;
+  indexAttributeNames;
+  constructor(executor, keyCondition, indexAttributeNames = []) {
     super();
     this.executor = executor;
     this.keyCondition = keyCondition;
+    this.indexAttributeNames = indexAttributeNames;
   }
   /**
    * Sets the maximum number of items to return from the query.
@@ -1616,6 +1645,24 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
     this.options.scanIndexForward = false;
     return this;
   }
+  /**
+   * Ensures index attributes are included in the result.
+   * By default, index attributes are removed from query responses.
+   */
+  includeIndexes() {
+    this.includeIndexAttributes = true;
+    if (this.selectedFields.size > 0) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
+  select(fields) {
+    super.select(fields);
+    if (this.includeIndexAttributes) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
   /**
    * Creates a deep clone of this QueryBuilder instance.
    *
@@ -1650,12 +1697,13 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
    * @returns A new QueryBuilder instance with the same configuration
    */
   clone() {
-    const clone = new _QueryBuilder(this.executor, this.keyCondition);
+    const clone = new _QueryBuilder(this.executor, this.keyCondition, this.indexAttributeNames);
     clone.options = {
       ...this.options,
       filter: this.deepCloneFilter(this.options.filter)
     };
     clone.selectedFields = new Set(this.selectedFields);
+    clone.includeIndexAttributes = this.includeIndexAttributes;
     return clone;
   }
   deepCloneFilter(filter) {
@@ -1707,9 +1755,39 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
    * @returns A promise that resolves to a ResultGenerator that behaves like an array
    */
   async execute() {
-    const directExecutor = () => this.executor(this.keyCondition, this.options);
+    const directExecutor = async () => {
+      const result = await this.executor(this.keyCondition, this.options);
+      if (this.includeIndexAttributes || this.indexAttributeNames.length === 0) {
+        return result;
+      }
+      return {
+        ...result,
+        items: result.items.map((item) => this.omitIndexAttributes(item))
+      };
+    };
     return new ResultIterator(this, directExecutor);
   }
+  addIndexAttributesToSelection() {
+    if (this.indexAttributeNames.length === 0) return;
+    for (const attributeName of this.indexAttributeNames) {
+      this.selectedFields.add(attributeName);
+    }
+    this.options.projection = Array.from(this.selectedFields);
+  }
+  omitIndexAttributes(item) {
+    if (this.indexAttributeNames.length === 0) {
+      return item;
+    }
+    let didOmit = false;
+    const cleaned = { ...item };
+    for (const attributeName of this.indexAttributeNames) {
+      if (attributeName in cleaned) {
+        delete cleaned[attributeName];
+        didOmit = true;
+      }
+    }
+    return didOmit ? cleaned : item;
+  }
 };
 
 // src/utils/debug-transaction.ts
@@ -2993,16 +3071,19 @@ var GetBuilder = class {
    * @param key - Primary key of the item to retrieve
    * @param tableName - Name of the DynamoDB table
    */
-  constructor(executor, key, tableName) {
+  constructor(executor, key, tableName, indexAttributeNames = []) {
     this.executor = executor;
     this.params = {
       tableName,
       key
     };
+    this.indexAttributeNames = indexAttributeNames;
   }
   params;
   options = {};
   selectedFields = /* @__PURE__ */ new Set();
+  includeIndexAttributes = false;
+  indexAttributeNames;
   /**
    * Specifies which attributes to return in the get results.
    *
@@ -3031,9 +3112,23 @@ var GetBuilder = class {
         this.selectedFields.add(field);
       }
     }
+    if (this.includeIndexAttributes) {
+      this.addIndexAttributesToSelection();
+    }
     this.options.projection = Array.from(this.selectedFields);
     return this;
   }
+  /**
+   * Ensures index attributes are included in the result.
+   * By default, index attributes are removed from get responses.
+   */
+  includeIndexes() {
+    this.includeIndexAttributes = true;
+    if (this.selectedFields.size > 0) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
   /**
    * Sets whether to use strongly consistent reads for the get operation.
    * Use this method when you need:
@@ -3112,6 +3207,27 @@ var GetBuilder = class {
       expressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : void 0
     };
   }
+  addIndexAttributesToSelection() {
+    if (this.indexAttributeNames.length === 0) return;
+    for (const attributeName of this.indexAttributeNames) {
+      this.selectedFields.add(attributeName);
+    }
+    this.options.projection = Array.from(this.selectedFields);
+  }
+  omitIndexAttributes(item) {
+    if (!item || this.includeIndexAttributes || this.indexAttributeNames.length === 0) {
+      return item;
+    }
+    let didOmit = false;
+    const cleaned = { ...item };
+    for (const attributeName of this.indexAttributeNames) {
+      if (attributeName in cleaned) {
+        delete cleaned[attributeName];
+        didOmit = true;
+      }
+    }
+    return didOmit ? cleaned : item;
+  }
   /**
    * Executes the get operation against DynamoDB.
    *
@@ -3138,7 +3254,10 @@ var GetBuilder = class {
    */
   async execute() {
     const command = this.toDynamoCommand();
-    return this.executor(command);
+    const result = await this.executor(command);
+    return {
+      item: this.omitIndexAttributes(result.item)
+    };
   }
 };
 

package/dist/{chunk-64DG2EEI.js → chunk-42LH2UEM.js}

@@ -1,4 +1,4 @@
-import { GetBuilder, PutBuilder, QueryBuilder, ScanBuilder, DeleteBuilder, UpdateBuilder, TransactionBuilder, BatchBuilder, ConditionCheckBuilder, buildExpression, generateAttributeName } from './chunk-GWHGUKAL.js';
+import { GetBuilder, PutBuilder, QueryBuilder, ScanBuilder, DeleteBuilder, UpdateBuilder, TransactionBuilder, BatchBuilder, ConditionCheckBuilder, buildExpression, generateAttributeName } from './chunk-NYJGW3XH.js';
 import { ConfigurationErrors, OperationErrors } from './chunk-FF7FYGDH.js';
 import { eq, and, beginsWith, between, gte, gt, lte, lt } from './chunk-2WIBY7PZ.js';
 
@@ -37,6 +37,16 @@ var Table = class {
     this.sortKey = config.indexes.sortKey;
     this.gsis = config.indexes.gsis || {};
   }
+  getIndexAttributeNames() {
+    const names = /* @__PURE__ */ new Set();
+    for (const gsi of Object.values(this.gsis)) {
+      names.add(gsi.partitionKey);
+      if (gsi.sortKey) {
+        names.add(gsi.sortKey);
+      }
+    }
+    return Array.from(names);
+  }
   createKeyForPrimaryIndex(keyCondition) {
     const primaryCondition = { [this.partitionKey]: keyCondition.pk };
     if (this.sortKey) {
@@ -82,6 +92,7 @@ var Table = class {
     return this.put(item).condition((op) => op.attributeNotExists(this.partitionKey)).returnValues("INPUT");
   }
   get(keyCondition) {
+    const indexAttributeNames = this.getIndexAttributeNames();
     const executor = async (params) => {
       try {
         const result = await this.dynamoClient.get({
@@ -98,7 +109,7 @@ var Table = class {
         throw OperationErrors.getFailed(params.tableName, keyCondition, error instanceof Error ? error : void 0);
       }
     };
-    return new GetBuilder(executor, keyCondition, this.tableName);
+    return new GetBuilder(executor, keyCondition, this.tableName, indexAttributeNames);
   }
   /**
    * Updates an item in the table
@@ -145,6 +156,7 @@ var Table = class {
    * If useIndex is called on the returned QueryBuilder, it will use the GSI configuration
    */
   query(keyCondition) {
+    const indexAttributeNames = this.getIndexAttributeNames();
     const pkAttributeName = this.partitionKey;
     const skAttributeName = this.sortKey;
     let keyConditionExpression = eq(pkAttributeName, keyCondition.pk);
@@ -258,7 +270,7 @@ var Table = class {
         );
       }
     };
-    return new QueryBuilder(executor, keyConditionExpression);
+    return new QueryBuilder(executor, keyConditionExpression, indexAttributeNames);
   }
   /**
    * Creates a scan builder for scanning the entire table

package/dist/{chunk-GWHGUKAL.js → chunk-NYJGW3XH.js}

@@ -1465,6 +1465,32 @@ var FilterBuilder = class {
     this.options.lastEvaluatedKey = lastEvaluatedKey;
     return this;
   }
+  /**
+   * Executes the operation and returns the first matching item, if any.
+   *
+   * This helper:
+   * - Applies an internal limit of 1
+   * - Streams results until a match is found or there are no more pages
+   * - Avoids mutating the current builder by using a clone
+   *
+   * @example
+   * ```typescript
+   * const latest = await table
+   *   .query(eq("moduleId", moduleId))
+   *   .useIndex("module-version-index")
+   *   .sortDescending()
+   *   .findOne();
+   * ```
+   *
+   * @returns The first matching item, or undefined if none found
+   */
+  async findOne() {
+    const iterator = await this.clone().limit(1).execute();
+    for await (const item of iterator) {
+      return item;
+    }
+    return void 0;
+  }
 };
 
 // src/builders/result-iterator.ts
@@ -1538,10 +1564,13 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
   keyCondition;
   options = {};
   executor;
-  constructor(executor, keyCondition) {
+  includeIndexAttributes = false;
+  indexAttributeNames;
+  constructor(executor, keyCondition, indexAttributeNames = []) {
     super();
     this.executor = executor;
     this.keyCondition = keyCondition;
+    this.indexAttributeNames = indexAttributeNames;
   }
   /**
    * Sets the maximum number of items to return from the query.
@@ -1614,6 +1643,24 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
     this.options.scanIndexForward = false;
     return this;
   }
+  /**
+   * Ensures index attributes are included in the result.
+   * By default, index attributes are removed from query responses.
+   */
+  includeIndexes() {
+    this.includeIndexAttributes = true;
+    if (this.selectedFields.size > 0) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
+  select(fields) {
+    super.select(fields);
+    if (this.includeIndexAttributes) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
   /**
    * Creates a deep clone of this QueryBuilder instance.
    *
@@ -1648,12 +1695,13 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
    * @returns A new QueryBuilder instance with the same configuration
    */
   clone() {
-    const clone = new _QueryBuilder(this.executor, this.keyCondition);
+    const clone = new _QueryBuilder(this.executor, this.keyCondition, this.indexAttributeNames);
     clone.options = {
       ...this.options,
       filter: this.deepCloneFilter(this.options.filter)
     };
     clone.selectedFields = new Set(this.selectedFields);
+    clone.includeIndexAttributes = this.includeIndexAttributes;
     return clone;
   }
   deepCloneFilter(filter) {
@@ -1705,9 +1753,39 @@ var QueryBuilder = class _QueryBuilder extends FilterBuilder {
    * @returns A promise that resolves to a ResultGenerator that behaves like an array
    */
   async execute() {
-    const directExecutor = () => this.executor(this.keyCondition, this.options);
+    const directExecutor = async () => {
+      const result = await this.executor(this.keyCondition, this.options);
+      if (this.includeIndexAttributes || this.indexAttributeNames.length === 0) {
+        return result;
+      }
+      return {
+        ...result,
+        items: result.items.map((item) => this.omitIndexAttributes(item))
+      };
+    };
     return new ResultIterator(this, directExecutor);
   }
+  addIndexAttributesToSelection() {
+    if (this.indexAttributeNames.length === 0) return;
+    for (const attributeName of this.indexAttributeNames) {
+      this.selectedFields.add(attributeName);
+    }
+    this.options.projection = Array.from(this.selectedFields);
+  }
+  omitIndexAttributes(item) {
+    if (this.indexAttributeNames.length === 0) {
+      return item;
+    }
+    let didOmit = false;
+    const cleaned = { ...item };
+    for (const attributeName of this.indexAttributeNames) {
+      if (attributeName in cleaned) {
+        delete cleaned[attributeName];
+        didOmit = true;
+      }
+    }
+    return didOmit ? cleaned : item;
+  }
 };
 
 // src/utils/debug-transaction.ts
@@ -2991,16 +3069,19 @@ var GetBuilder = class {
    * @param key - Primary key of the item to retrieve
    * @param tableName - Name of the DynamoDB table
    */
-  constructor(executor, key, tableName) {
+  constructor(executor, key, tableName, indexAttributeNames = []) {
     this.executor = executor;
     this.params = {
       tableName,
       key
     };
+    this.indexAttributeNames = indexAttributeNames;
   }
   params;
   options = {};
   selectedFields = /* @__PURE__ */ new Set();
+  includeIndexAttributes = false;
+  indexAttributeNames;
   /**
    * Specifies which attributes to return in the get results.
    *
@@ -3029,9 +3110,23 @@ var GetBuilder = class {
         this.selectedFields.add(field);
       }
     }
+    if (this.includeIndexAttributes) {
+      this.addIndexAttributesToSelection();
+    }
     this.options.projection = Array.from(this.selectedFields);
     return this;
   }
+  /**
+   * Ensures index attributes are included in the result.
+   * By default, index attributes are removed from get responses.
+   */
+  includeIndexes() {
+    this.includeIndexAttributes = true;
+    if (this.selectedFields.size > 0) {
+      this.addIndexAttributesToSelection();
+    }
+    return this;
+  }
   /**
    * Sets whether to use strongly consistent reads for the get operation.
    * Use this method when you need:
@@ -3110,6 +3205,27 @@ var GetBuilder = class {
       expressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : void 0
     };
   }
+  addIndexAttributesToSelection() {
+    if (this.indexAttributeNames.length === 0) return;
+    for (const attributeName of this.indexAttributeNames) {
+      this.selectedFields.add(attributeName);
+    }
+    this.options.projection = Array.from(this.selectedFields);
+  }
+  omitIndexAttributes(item) {
+    if (!item || this.includeIndexAttributes || this.indexAttributeNames.length === 0) {
+      return item;
+    }
+    let didOmit = false;
+    const cleaned = { ...item };
+    for (const attributeName of this.indexAttributeNames) {
+      if (attributeName in cleaned) {
+        delete cleaned[attributeName];
+        didOmit = true;
+      }
+    }
+    return didOmit ? cleaned : item;
+  }
   /**
    * Executes the get operation against DynamoDB.
    *
@@ -3136,7 +3252,10 @@ var GetBuilder = class {
    */
   async execute() {
     const command = this.toDynamoCommand();
-    return this.executor(command);
+    const result = await this.executor(command);
+    return {
+      item: this.omitIndexAttributes(result.item)
+    };
   }
 };
 

package/dist/{chunk-OLURZQ7R.cjs → chunk-ZUBCW3LA.cjs}

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkAHF4H42Q_cjs = require('./chunk-AHF4H42Q.cjs');
+var chunk3DR6VOFW_cjs = require('./chunk-3DR6VOFW.cjs');
 var chunkELULXDSB_cjs = require('./chunk-ELULXDSB.cjs');
 var chunk7UJJ7JXM_cjs = require('./chunk-7UJJ7JXM.cjs');
 
@@ -39,6 +39,16 @@ var Table = class {
     this.sortKey = config.indexes.sortKey;
     this.gsis = config.indexes.gsis || {};
   }
+  getIndexAttributeNames() {
+    const names = /* @__PURE__ */ new Set();
+    for (const gsi of Object.values(this.gsis)) {
+      names.add(gsi.partitionKey);
+      if (gsi.sortKey) {
+        names.add(gsi.sortKey);
+      }
+    }
+    return Array.from(names);
+  }
   createKeyForPrimaryIndex(keyCondition) {
     const primaryCondition = { [this.partitionKey]: keyCondition.pk };
     if (this.sortKey) {
@@ -84,6 +94,7 @@ var Table = class {
     return this.put(item).condition((op) => op.attributeNotExists(this.partitionKey)).returnValues("INPUT");
   }
   get(keyCondition) {
+    const indexAttributeNames = this.getIndexAttributeNames();
     const executor = async (params) => {
       try {
         const result = await this.dynamoClient.get({
@@ -100,7 +111,7 @@ var Table = class {
         throw chunkELULXDSB_cjs.OperationErrors.getFailed(params.tableName, keyCondition, error instanceof Error ? error : void 0);
       }
     };
-    return new chunkAHF4H42Q_cjs.GetBuilder(executor, keyCondition, this.tableName);
+    return new chunk3DR6VOFW_cjs.GetBuilder(executor, keyCondition, this.tableName, indexAttributeNames);
   }
   /**
    * Updates an item in the table
@@ -140,13 +151,14 @@ var Table = class {
         throw chunkELULXDSB_cjs.OperationErrors.putFailed(params.tableName, params.item, error instanceof Error ? error : void 0);
       }
     };
-    return new chunkAHF4H42Q_cjs.PutBuilder(executor, item, this.tableName);
+    return new chunk3DR6VOFW_cjs.PutBuilder(executor, item, this.tableName);
   }
   /**
    * Creates a query builder for complex queries
    * If useIndex is called on the returned QueryBuilder, it will use the GSI configuration
    */
   query(keyCondition) {
+    const indexAttributeNames = this.getIndexAttributeNames();
     const pkAttributeName = this.partitionKey;
     const skAttributeName = this.sortKey;
     let keyConditionExpression = chunk7UJJ7JXM_cjs.eq(pkAttributeName, keyCondition.pk);
@@ -225,12 +237,12 @@ var Table = class {
         expressionAttributeValues: {},
         valueCounter: { count: 0 }
       };
-      const keyConditionExpression2 = chunkAHF4H42Q_cjs.buildExpression(finalKeyCondition, expressionParams);
+      const keyConditionExpression2 = chunk3DR6VOFW_cjs.buildExpression(finalKeyCondition, expressionParams);
       let filterExpression;
       if (options.filter) {
-        filterExpression = chunkAHF4H42Q_cjs.buildExpression(options.filter, expressionParams);
+        filterExpression = chunk3DR6VOFW_cjs.buildExpression(options.filter, expressionParams);
       }
-      const projectionExpression = options.projection?.map((p) => chunkAHF4H42Q_cjs.generateAttributeName(expressionParams, p)).join(", ");
+      const projectionExpression = options.projection?.map((p) => chunk3DR6VOFW_cjs.generateAttributeName(expressionParams, p)).join(", ");
       const { expressionAttributeNames, expressionAttributeValues } = expressionParams;
       const { indexName, limit, consistentRead, scanIndexForward, lastEvaluatedKey } = options;
       const params = {
@@ -260,7 +272,7 @@ var Table = class {
         );
       }
     };
-    return new chunkAHF4H42Q_cjs.QueryBuilder(executor, keyConditionExpression);
+    return new chunk3DR6VOFW_cjs.QueryBuilder(executor, keyConditionExpression, indexAttributeNames);
   }
   /**
    * Creates a scan builder for scanning the entire table
@@ -280,9 +292,9 @@ var Table = class {
       };
       let filterExpression;
       if (options.filter) {
-        filterExpression = chunkAHF4H42Q_cjs.buildExpression(options.filter, expressionParams);
+        filterExpression = chunk3DR6VOFW_cjs.buildExpression(options.filter, expressionParams);
       }
-      const projectionExpression = options.projection?.map((p) => chunkAHF4H42Q_cjs.generateAttributeName(expressionParams, p)).join(", ");
+      const projectionExpression = options.projection?.map((p) => chunk3DR6VOFW_cjs.generateAttributeName(expressionParams, p)).join(", ");
       const { expressionAttributeNames, expressionAttributeValues } = expressionParams;
       const { indexName, limit, consistentRead, lastEvaluatedKey } = options;
       const params = {
@@ -310,7 +322,7 @@ var Table = class {
         );
       }
     };
-    return new chunkAHF4H42Q_cjs.ScanBuilder(executor);
+    return new chunk3DR6VOFW_cjs.ScanBuilder(executor);
   }
   delete(keyCondition) {
     const executor = async (params) => {
@@ -330,7 +342,7 @@ var Table = class {
         throw chunkELULXDSB_cjs.OperationErrors.deleteFailed(params.tableName, keyCondition, error instanceof Error ? error : void 0);
       }
     };
-    return new chunkAHF4H42Q_cjs.DeleteBuilder(executor, this.tableName, keyCondition);
+    return new chunk3DR6VOFW_cjs.DeleteBuilder(executor, this.tableName, keyCondition);
   }
   /**
    * Updates an item in the table
@@ -357,7 +369,7 @@ var Table = class {
         throw chunkELULXDSB_cjs.OperationErrors.updateFailed(params.tableName, keyCondition, error instanceof Error ? error : void 0);
       }
     };
-    return new chunkAHF4H42Q_cjs.UpdateBuilder(executor, this.tableName, keyCondition);
+    return new chunk3DR6VOFW_cjs.UpdateBuilder(executor, this.tableName, keyCondition);
   }
   /**
    * Creates a transaction builder for performing multiple operations atomically
@@ -366,7 +378,7 @@ var Table = class {
     const executor = async (params) => {
       await this.dynamoClient.transactWrite(params);
     };
-    return new chunkAHF4H42Q_cjs.TransactionBuilder(executor, {
+    return new chunk3DR6VOFW_cjs.TransactionBuilder(executor, {
       partitionKey: this.partitionKey,
       sortKey: this.sortKey
     });
@@ -413,7 +425,7 @@ var Table = class {
     const batchGetExecutor = async (keys) => {
       return this.batchGet(keys);
     };
-    return new chunkAHF4H42Q_cjs.BatchBuilder(batchWriteExecutor, batchGetExecutor, {
+    return new chunk3DR6VOFW_cjs.BatchBuilder(batchWriteExecutor, batchGetExecutor, {
       partitionKey: this.partitionKey,
       sortKey: this.sortKey
     });
@@ -429,7 +441,7 @@ var Table = class {
     const transactionExecutor = async (params) => {
       await this.dynamoClient.transactWrite(params);
     };
-    const transaction = new chunkAHF4H42Q_cjs.TransactionBuilder(transactionExecutor, {
+    const transaction = new chunk3DR6VOFW_cjs.TransactionBuilder(transactionExecutor, {
       partitionKey: this.partitionKey,
       sortKey: this.sortKey
     });
@@ -449,7 +461,7 @@ var Table = class {
    * For example, you are updating a record and you want to ensure that another record exists and/or has a specific value before proceeding.
    */
   conditionCheck(keyCondition) {
-    return new chunkAHF4H42Q_cjs.ConditionCheckBuilder(this.tableName, keyCondition);
+    return new chunk3DR6VOFW_cjs.ConditionCheckBuilder(this.tableName, keyCondition);
   }
   /**
    * Performs a batch get operation to retrieve multiple items at once

package/dist/entity.d.cts

@@ -1,5 +1,5 @@
 import { s as Path, t as PathType, b as Condition, c as ConditionOperator, P as PrimaryKeyWithoutExpression, a as PrimaryKey } from './conditions-C8bM__Pn.cjs';
-import { P as PutBuilder, G as GetBuilder, U as UpdateBuilder, p as UpdateCommandParams, T as TransactionBuilder, D as DeleteBuilder, S as ScanBuilder, Q as QueryBuilder } from './index-BX-MSZHj.cjs';
+import { P as PutBuilder, G as GetBuilder, U as UpdateBuilder, p as UpdateCommandParams, T as TransactionBuilder, D as DeleteBuilder, S as ScanBuilder, Q as QueryBuilder } from './index-CPCmWsEv.cjs';
 import { StandardSchemaV1 } from './standard-schema.cjs';
 import { Table } from './table.cjs';
 import { DynamoItem, Index, TableConfig } from './types.cjs';

package/dist/entity.d.ts

@@ -1,5 +1,5 @@
 import { s as Path, t as PathType, b as Condition, c as ConditionOperator, P as PrimaryKeyWithoutExpression, a as PrimaryKey } from './conditions-BSAcZswY.js';
-import { P as PutBuilder, G as GetBuilder, U as UpdateBuilder, p as UpdateCommandParams, T as TransactionBuilder, D as DeleteBuilder, S as ScanBuilder, Q as QueryBuilder } from './index-DdTolMJW.js';
+import { P as PutBuilder, G as GetBuilder, U as UpdateBuilder, p as UpdateCommandParams, T as TransactionBuilder, D as DeleteBuilder, S as ScanBuilder, Q as QueryBuilder } from './index-Bc-ra0im.js';
 import { StandardSchemaV1 } from './standard-schema.js';
 import { Table } from './table.js';
 import { DynamoItem, Index, TableConfig } from './types.js';

package/dist/{index-DdTolMJW.d.ts → index-Bc-ra0im.d.ts}

@@ -354,6 +354,7 @@ interface BaseBuilderInterface<T extends DynamoItem, TConfig extends TableConfig
     getLimit(): number | undefined;
     startFrom(lastEvaluatedKey: DynamoItem): B;
     execute(): Promise<ResultIterator<T, TConfig>>;
+    findOne(): Promise<T | undefined>;
 }
 /**
  * Interface for the QueryBuilder class to be used by Paginator
@@ -459,6 +460,8 @@ declare class GetBuilder<T extends DynamoItem> {
     private readonly params;
     private options;
     private selectedFields;
+    private includeIndexAttributes;
+    private readonly indexAttributeNames;
     /**
      * Creates a new GetBuilder instance.
      *
@@ -466,7 +469,7 @@ declare class GetBuilder<T extends DynamoItem> {
      * @param key - Primary key of the item to retrieve
      * @param tableName - Name of the DynamoDB table
      */
-    constructor(executor: GetExecutor<T>, key: PrimaryKeyWithoutExpression, tableName: string);
+    constructor(executor: GetExecutor<T>, key: PrimaryKeyWithoutExpression, tableName: string, indexAttributeNames?: string[]);
     /**
      * Specifies which attributes to return in the get results.
      *
@@ -488,6 +491,11 @@ declare class GetBuilder<T extends DynamoItem> {
      * @returns The builder instance for method chaining
      */
     select<K extends Path<T>>(fields: K | K[]): GetBuilder<T>;
+    /**
+     * Ensures index attributes are included in the result.
+     * By default, index attributes are removed from get responses.
+     */
+    includeIndexes(): GetBuilder<T>;
     /**
      * Sets whether to use strongly consistent reads for the get operation.
      * Use this method when you need:
@@ -550,6 +558,8 @@ declare class GetBuilder<T extends DynamoItem> {
      * Converts the builder configuration to a DynamoDB command
      */
     private toDynamoCommand;
+    private addIndexAttributesToSelection;
+    private omitIndexAttributes;
     /**
      * Executes the get operation against DynamoDB.
      *
@@ -2176,6 +2186,26 @@ declare abstract class FilterBuilder<T extends DynamoItem, TConfig extends Table
      * their specific execution logic.
      */
     abstract execute(): Promise<ResultIterator<T, TConfig>>;
+    /**
+     * Executes the operation and returns the first matching item, if any.
+     *
+     * This helper:
+     * - Applies an internal limit of 1
+     * - Streams results until a match is found or there are no more pages
+     * - Avoids mutating the current builder by using a clone
+     *
+     * @example
+     * ```typescript
+     * const latest = await table
+     *   .query(eq("moduleId", moduleId))
+     *   .useIndex("module-version-index")
+     *   .sortDescending()
+     *   .findOne();
+     * ```
+     *
+     * @returns The first matching item, or undefined if none found
+     */
+    findOne(): Promise<T | undefined>;
 }
 
 /**
@@ -2238,7 +2268,9 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
     private readonly keyCondition;
     protected options: QueryOptions;
     protected readonly executor: QueryExecutor<T>;
-    constructor(executor: QueryExecutor<T>, keyCondition: Condition);
+    private includeIndexAttributes;
+    private readonly indexAttributeNames;
+    constructor(executor: QueryExecutor<T>, keyCondition: Condition, indexAttributeNames?: string[]);
     /**
      * Sets the maximum number of items to return from the query.
      *
@@ -2304,6 +2336,12 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
      * @returns The builder instance for method chaining
      */
     sortDescending(): this;
+    /**
+     * Ensures index attributes are included in the result.
+     * By default, index attributes are removed from query responses.
+     */
+    includeIndexes(): this;
+    select<K extends Path<T>>(fields: K | K[]): this;
     /**
      * Creates a deep clone of this QueryBuilder instance.
      *
@@ -2378,6 +2416,8 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
      * @returns A promise that resolves to a ResultGenerator that behaves like an array
      */
     execute(): Promise<ResultIterator<T, TConfig>>;
+    private addIndexAttributesToSelection;
+    private omitIndexAttributes;
 }
 
 /**
@@ -2999,4 +3039,4 @@ declare class ScanBuilder<T extends DynamoItem, TConfig extends TableConfig = Ta
     execute(): Promise<ResultIterator<T, TConfig>>;
 }
 
-export { BatchBuilder as B, ConditionCheckBuilder as C, DeleteBuilder as D, ExpressionError as E, FilterBuilder as F, GetBuilder as G, IndexGenerationError as I, KeyGenerationError as K, OperationError as O, PutBuilder as P, QueryBuilder as Q, ResultIterator as R, ScanBuilder as S, TransactionBuilder as T, UpdateBuilder as U, ValidationError as V, type TransactionOptions as a, type BatchWriteOperation as b, BatchError as c, ConfigurationError as d, EntityValidationError as e, TransactionError as f, DynoTableError as g, EntityError as h, type BatchResult as i, type DeleteOptions as j, type PutOptions as k, type QueryOptions as l, type UpdateOptions as m, ErrorCodes as n, type ErrorCode as o, type UpdateCommandParams as p, Paginator as q, type DeleteCommandParams as r, type PutCommandParams as s, type ConditionCheckCommandParams as t, type BaseBuilderInterface as u, type QueryBuilderInterface as v, type ScanBuilderInterface as w, type FilterBuilderInterface as x, type PaginationResult as y, type TransactionItem as z };
+export { BatchBuilder as B, ConditionCheckBuilder as C, DeleteBuilder as D, ExpressionError as E, FilterBuilder as F, GetBuilder as G, IndexGenerationError as I, KeyGenerationError as K, OperationError as O, PutBuilder as P, QueryBuilder as Q, ResultIterator as R, ScanBuilder as S, TransactionBuilder as T, UpdateBuilder as U, ValidationError as V, type TransactionOptions as a, type BatchWriteOperation as b, BatchError as c, ConfigurationError as d, EntityValidationError as e, TransactionError as f, DynoTableError as g, EntityError as h, type BatchResult as i, type DeleteOptions as j, type ErrorCode as k, ErrorCodes as l, type PutOptions as m, type QueryOptions as n, type UpdateOptions as o, type UpdateCommandParams as p, type BaseBuilderInterface as q, type ConditionCheckCommandParams as r, type DeleteCommandParams as s, type FilterBuilderInterface as t, type PaginationResult as u, Paginator as v, type PutCommandParams as w, type QueryBuilderInterface as x, type ScanBuilderInterface as y, type TransactionItem as z };

package/dist/{index-BX-MSZHj.d.cts → index-CPCmWsEv.d.cts}

@@ -354,6 +354,7 @@ interface BaseBuilderInterface<T extends DynamoItem, TConfig extends TableConfig
     getLimit(): number | undefined;
     startFrom(lastEvaluatedKey: DynamoItem): B;
     execute(): Promise<ResultIterator<T, TConfig>>;
+    findOne(): Promise<T | undefined>;
 }
 /**
  * Interface for the QueryBuilder class to be used by Paginator
@@ -459,6 +460,8 @@ declare class GetBuilder<T extends DynamoItem> {
     private readonly params;
     private options;
     private selectedFields;
+    private includeIndexAttributes;
+    private readonly indexAttributeNames;
     /**
      * Creates a new GetBuilder instance.
      *
@@ -466,7 +469,7 @@ declare class GetBuilder<T extends DynamoItem> {
      * @param key - Primary key of the item to retrieve
      * @param tableName - Name of the DynamoDB table
      */
-    constructor(executor: GetExecutor<T>, key: PrimaryKeyWithoutExpression, tableName: string);
+    constructor(executor: GetExecutor<T>, key: PrimaryKeyWithoutExpression, tableName: string, indexAttributeNames?: string[]);
     /**
      * Specifies which attributes to return in the get results.
      *
@@ -488,6 +491,11 @@ declare class GetBuilder<T extends DynamoItem> {
      * @returns The builder instance for method chaining
      */
     select<K extends Path<T>>(fields: K | K[]): GetBuilder<T>;
+    /**
+     * Ensures index attributes are included in the result.
+     * By default, index attributes are removed from get responses.
+     */
+    includeIndexes(): GetBuilder<T>;
     /**
      * Sets whether to use strongly consistent reads for the get operation.
      * Use this method when you need:
@@ -550,6 +558,8 @@ declare class GetBuilder<T extends DynamoItem> {
      * Converts the builder configuration to a DynamoDB command
      */
     private toDynamoCommand;
+    private addIndexAttributesToSelection;
+    private omitIndexAttributes;
     /**
      * Executes the get operation against DynamoDB.
      *
@@ -2176,6 +2186,26 @@ declare abstract class FilterBuilder<T extends DynamoItem, TConfig extends Table
      * their specific execution logic.
      */
     abstract execute(): Promise<ResultIterator<T, TConfig>>;
+    /**
+     * Executes the operation and returns the first matching item, if any.
+     *
+     * This helper:
+     * - Applies an internal limit of 1
+     * - Streams results until a match is found or there are no more pages
+     * - Avoids mutating the current builder by using a clone
+     *
+     * @example
+     * ```typescript
+     * const latest = await table
+     *   .query(eq("moduleId", moduleId))
+     *   .useIndex("module-version-index")
+     *   .sortDescending()
+     *   .findOne();
+     * ```
+     *
+     * @returns The first matching item, or undefined if none found
+     */
+    findOne(): Promise<T | undefined>;
 }
 
 /**
@@ -2238,7 +2268,9 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
     private readonly keyCondition;
     protected options: QueryOptions;
     protected readonly executor: QueryExecutor<T>;
-    constructor(executor: QueryExecutor<T>, keyCondition: Condition);
+    private includeIndexAttributes;
+    private readonly indexAttributeNames;
+    constructor(executor: QueryExecutor<T>, keyCondition: Condition, indexAttributeNames?: string[]);
     /**
      * Sets the maximum number of items to return from the query.
      *
@@ -2304,6 +2336,12 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
      * @returns The builder instance for method chaining
      */
     sortDescending(): this;
+    /**
+     * Ensures index attributes are included in the result.
+     * By default, index attributes are removed from query responses.
+     */
+    includeIndexes(): this;
+    select<K extends Path<T>>(fields: K | K[]): this;
     /**
      * Creates a deep clone of this QueryBuilder instance.
      *
@@ -2378,6 +2416,8 @@ declare class QueryBuilder<T extends DynamoItem, TConfig extends TableConfig = T
      * @returns A promise that resolves to a ResultGenerator that behaves like an array
      */
     execute(): Promise<ResultIterator<T, TConfig>>;
+    private addIndexAttributesToSelection;
+    private omitIndexAttributes;
 }
 
 /**
@@ -2999,4 +3039,4 @@ declare class ScanBuilder<T extends DynamoItem, TConfig extends TableConfig = Ta
     execute(): Promise<ResultIterator<T, TConfig>>;
 }
 
-export { BatchBuilder as B, ConditionCheckBuilder as C, DeleteBuilder as D, ExpressionError as E, FilterBuilder as F, GetBuilder as G, IndexGenerationError as I, KeyGenerationError as K, OperationError as O, PutBuilder as P, QueryBuilder as Q, ResultIterator as R, ScanBuilder as S, TransactionBuilder as T, UpdateBuilder as U, ValidationError as V, type TransactionOptions as a, type BatchWriteOperation as b, BatchError as c, ConfigurationError as d, EntityValidationError as e, TransactionError as f, DynoTableError as g, EntityError as h, type BatchResult as i, type DeleteOptions as j, type PutOptions as k, type QueryOptions as l, type UpdateOptions as m, ErrorCodes as n, type ErrorCode as o, type UpdateCommandParams as p, Paginator as q, type DeleteCommandParams as r, type PutCommandParams as s, type ConditionCheckCommandParams as t, type BaseBuilderInterface as u, type QueryBuilderInterface as v, type ScanBuilderInterface as w, type FilterBuilderInterface as x, type PaginationResult as y, type TransactionItem as z };
+export { BatchBuilder as B, ConditionCheckBuilder as C, DeleteBuilder as D, ExpressionError as E, FilterBuilder as F, GetBuilder as G, IndexGenerationError as I, KeyGenerationError as K, OperationError as O, PutBuilder as P, QueryBuilder as Q, ResultIterator as R, ScanBuilder as S, TransactionBuilder as T, UpdateBuilder as U, ValidationError as V, type TransactionOptions as a, type BatchWriteOperation as b, BatchError as c, ConfigurationError as d, EntityValidationError as e, TransactionError as f, DynoTableError as g, EntityError as h, type BatchResult as i, type DeleteOptions as j, type ErrorCode as k, ErrorCodes as l, type PutOptions as m, type QueryOptions as n, type UpdateOptions as o, type UpdateCommandParams as p, type BaseBuilderInterface as q, type ConditionCheckCommandParams as r, type DeleteCommandParams as s, type FilterBuilderInterface as t, type PaginationResult as u, Paginator as v, type PutCommandParams as w, type QueryBuilderInterface as x, type ScanBuilderInterface as y, type TransactionItem as z };

package/dist/index.cjs

@@ -1,9 +1,9 @@
 'use strict';
 
-var chunkOLURZQ7R_cjs = require('./chunk-OLURZQ7R.cjs');
+var chunkZUBCW3LA_cjs = require('./chunk-ZUBCW3LA.cjs');
 var chunkZXM6LPRV_cjs = require('./chunk-ZXM6LPRV.cjs');
 var chunkPB7BBCZO_cjs = require('./chunk-PB7BBCZO.cjs');
-var chunkAHF4H42Q_cjs = require('./chunk-AHF4H42Q.cjs');
+var chunk3DR6VOFW_cjs = require('./chunk-3DR6VOFW.cjs');
 var chunkELULXDSB_cjs = require('./chunk-ELULXDSB.cjs');
 var chunk7UJJ7JXM_cjs = require('./chunk-7UJJ7JXM.cjs');
 
@@ -11,7 +11,7 @@ var chunk7UJJ7JXM_cjs = require('./chunk-7UJJ7JXM.cjs');
 
 Object.defineProperty(exports, "Table", {
   enumerable: true,
-  get: function () { return chunkOLURZQ7R_cjs.Table; }
+  get: function () { return chunkZUBCW3LA_cjs.Table; }
 });
 Object.defineProperty(exports, "createIndex", {
   enumerable: true,
@@ -119,27 +119,27 @@ Object.defineProperty(exports, "sortKey", {
 });
 Object.defineProperty(exports, "BatchBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.BatchBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.BatchBuilder; }
 });
 Object.defineProperty(exports, "DeleteBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.DeleteBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.DeleteBuilder; }
 });
 Object.defineProperty(exports, "PutBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.PutBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.PutBuilder; }
 });
 Object.defineProperty(exports, "QueryBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.QueryBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.QueryBuilder; }
 });
 Object.defineProperty(exports, "TransactionBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.TransactionBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.TransactionBuilder; }
 });
 Object.defineProperty(exports, "UpdateBuilder", {
   enumerable: true,
-  get: function () { return chunkAHF4H42Q_cjs.UpdateBuilder; }
+  get: function () { return chunk3DR6VOFW_cjs.UpdateBuilder; }
 });
 Object.defineProperty(exports, "BatchError", {
   enumerable: true,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { c as BatchError, d as ConfigurationError, E as ExpressionError, e as EntityValidationError, K as KeyGenerationError, I as IndexGenerationError, O as OperationError, f as TransactionError, V as ValidationError, g as DynoTableError, h as EntityError } from './index-BX-MSZHj.cjs';
-export { B as BatchBuilder, i as BatchResult, D as DeleteBuilder, j as DeleteOptions, o as ErrorCode, n as ErrorCodes, P as PutBuilder, k as PutOptions, Q as QueryBuilder, l as QueryOptions, T as TransactionBuilder, a as TransactionOptions, U as UpdateBuilder, m as UpdateOptions } from './index-BX-MSZHj.cjs';
+import { c as BatchError, d as ConfigurationError, E as ExpressionError, e as EntityValidationError, K as KeyGenerationError, I as IndexGenerationError, O as OperationError, f as TransactionError, V as ValidationError, g as DynoTableError, h as EntityError } from './index-CPCmWsEv.cjs';
+export { B as BatchBuilder, i as BatchResult, D as DeleteBuilder, j as DeleteOptions, k as ErrorCode, l as ErrorCodes, P as PutBuilder, m as PutOptions, Q as QueryBuilder, n as QueryOptions, T as TransactionBuilder, a as TransactionOptions, U as UpdateBuilder, o as UpdateOptions } from './index-CPCmWsEv.cjs';
 export { C as ComparisonOperator, b as Condition, c as ConditionOperator, E as ExpressionParams, K as KeyConditionOperator, L as LogicalOperator, a as PrimaryKey, P as PrimaryKeyWithoutExpression, d as and, e as attributeExists, f as attributeNotExists, g as beginsWith, h as between, i as contains, j as eq, k as gt, l as gte, m as inArray, n as lt, o as lte, p as ne, q as not, r as or } from './conditions-C8bM__Pn.cjs';
 export { EntityConfig, EntityRepository, IndexDefinition, QueryEntity, QueryRecord, createIndex, createQueries, defineEntity } from './entity.cjs';
 export { Table } from './table.cjs';

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { c as BatchError, d as ConfigurationError, E as ExpressionError, e as EntityValidationError, K as KeyGenerationError, I as IndexGenerationError, O as OperationError, f as TransactionError, V as ValidationError, g as DynoTableError, h as EntityError } from './index-DdTolMJW.js';
-export { B as BatchBuilder, i as BatchResult, D as DeleteBuilder, j as DeleteOptions, o as ErrorCode, n as ErrorCodes, P as PutBuilder, k as PutOptions, Q as QueryBuilder, l as QueryOptions, T as TransactionBuilder, a as TransactionOptions, U as UpdateBuilder, m as UpdateOptions } from './index-DdTolMJW.js';
+import { c as BatchError, d as ConfigurationError, E as ExpressionError, e as EntityValidationError, K as KeyGenerationError, I as IndexGenerationError, O as OperationError, f as TransactionError, V as ValidationError, g as DynoTableError, h as EntityError } from './index-Bc-ra0im.js';
+export { B as BatchBuilder, i as BatchResult, D as DeleteBuilder, j as DeleteOptions, k as ErrorCode, l as ErrorCodes, P as PutBuilder, m as PutOptions, Q as QueryBuilder, n as QueryOptions, T as TransactionBuilder, a as TransactionOptions, U as UpdateBuilder, o as UpdateOptions } from './index-Bc-ra0im.js';
 export { C as ComparisonOperator, b as Condition, c as ConditionOperator, E as ExpressionParams, K as KeyConditionOperator, L as LogicalOperator, a as PrimaryKey, P as PrimaryKeyWithoutExpression, d as and, e as attributeExists, f as attributeNotExists, g as beginsWith, h as between, i as contains, j as eq, k as gt, l as gte, m as inArray, n as lt, o as lte, p as ne, q as not, r as or } from './conditions-BSAcZswY.js';
 export { EntityConfig, EntityRepository, IndexDefinition, QueryEntity, QueryRecord, createIndex, createQueries, defineEntity } from './entity.js';
 export { Table } from './table.js';

package/dist/index.js

@@ -1,6 +1,6 @@
-export { Table } from './chunk-64DG2EEI.js';
+export { Table } from './chunk-42LH2UEM.js';
 export { createIndex, createQueries, defineEntity, extractRequiredAttributes, formatErrorContext, getAwsErrorCode, getAwsErrorMessage, getErrorSummary, isBatchError, isConditionalCheckFailed, isConfigurationError, isDynoTableError, isEntityError, isEntityValidationError, isExpressionError, isIndexGenerationError, isKeyGenerationError, isOperationError, isProvisionedThroughputExceeded, isRetryableError, isTransactionCanceled, isTransactionError, isValidationError, isValidationException } from './chunk-U6MQGB6Y.js';
 export { partitionKey, sortKey } from './chunk-QVRMYGC4.js';
-export { BatchBuilder, DeleteBuilder, PutBuilder, QueryBuilder, TransactionBuilder, UpdateBuilder } from './chunk-GWHGUKAL.js';
+export { BatchBuilder, DeleteBuilder, PutBuilder, QueryBuilder, TransactionBuilder, UpdateBuilder } from './chunk-NYJGW3XH.js';
 export { BatchError, BatchErrors, ConfigurationError, ConfigurationErrors, DynoTableError, EntityError, EntityErrors, EntityValidationError, ErrorCodes, ExpressionError, ExpressionErrors, IndexErrors, IndexGenerationError, KeyGenerationError, OperationError, OperationErrors, TransactionError, TransactionErrors, ValidationError, ValidationErrors } from './chunk-FF7FYGDH.js';
 export { and, attributeExists, attributeNotExists, beginsWith, between, contains, eq, gt, gte, inArray, lt, lte, ne, not, or } from './chunk-2WIBY7PZ.js';

package/dist/table.cjs

@@ -1,7 +1,7 @@
 'use strict';
 
-var chunkOLURZQ7R_cjs = require('./chunk-OLURZQ7R.cjs');
-require('./chunk-AHF4H42Q.cjs');
+var chunkZUBCW3LA_cjs = require('./chunk-ZUBCW3LA.cjs');
+require('./chunk-3DR6VOFW.cjs');
 require('./chunk-ELULXDSB.cjs');
 require('./chunk-7UJJ7JXM.cjs');
 
@@ -9,5 +9,5 @@ require('./chunk-7UJJ7JXM.cjs');
 
 Object.defineProperty(exports, "Table", {
   enumerable: true,
-  get: function () { return chunkOLURZQ7R_cjs.Table; }
+  get: function () { return chunkZUBCW3LA_cjs.Table; }
 });

package/dist/table.d.cts

@@ -1,4 +1,4 @@
-import { P as PutBuilder, G as GetBuilder, Q as QueryBuilder, S as ScanBuilder, D as DeleteBuilder, U as UpdateBuilder, T as TransactionBuilder, B as BatchBuilder, a as TransactionOptions, C as ConditionCheckBuilder, b as BatchWriteOperation } from './index-BX-MSZHj.cjs';
+import { P as PutBuilder, G as GetBuilder, Q as QueryBuilder, S as ScanBuilder, D as DeleteBuilder, U as UpdateBuilder, T as TransactionBuilder, B as BatchBuilder, a as TransactionOptions, C as ConditionCheckBuilder, b as BatchWriteOperation } from './index-CPCmWsEv.cjs';
 import { P as PrimaryKeyWithoutExpression, a as PrimaryKey } from './conditions-C8bM__Pn.cjs';
 import { TableConfig, Index, DynamoItem } from './types.cjs';
 import '@aws-sdk/lib-dynamodb';
@@ -19,6 +19,7 @@ declare class Table<TConfig extends TableConfig = TableConfig> {
      */
     readonly gsis: Record<string, Index>;
     constructor(config: TConfig);
+    private getIndexAttributeNames;
     protected createKeyForPrimaryIndex(keyCondition: PrimaryKeyWithoutExpression): Record<string, unknown>;
     /**
      * Creates a new item in the table, it will fail if the item already exists.

package/dist/table.d.ts

@@ -1,4 +1,4 @@
-import { P as PutBuilder, G as GetBuilder, Q as QueryBuilder, S as ScanBuilder, D as DeleteBuilder, U as UpdateBuilder, T as TransactionBuilder, B as BatchBuilder, a as TransactionOptions, C as ConditionCheckBuilder, b as BatchWriteOperation } from './index-DdTolMJW.js';
+import { P as PutBuilder, G as GetBuilder, Q as QueryBuilder, S as ScanBuilder, D as DeleteBuilder, U as UpdateBuilder, T as TransactionBuilder, B as BatchBuilder, a as TransactionOptions, C as ConditionCheckBuilder, b as BatchWriteOperation } from './index-Bc-ra0im.js';
 import { P as PrimaryKeyWithoutExpression, a as PrimaryKey } from './conditions-BSAcZswY.js';
 import { TableConfig, Index, DynamoItem } from './types.js';
 import '@aws-sdk/lib-dynamodb';
@@ -19,6 +19,7 @@ declare class Table<TConfig extends TableConfig = TableConfig> {
      */
     readonly gsis: Record<string, Index>;
     constructor(config: TConfig);
+    private getIndexAttributeNames;
     protected createKeyForPrimaryIndex(keyCondition: PrimaryKeyWithoutExpression): Record<string, unknown>;
     /**
      * Creates a new item in the table, it will fail if the item already exists.

package/dist/table.js

@@ -1,4 +1,4 @@
-export { Table } from './chunk-64DG2EEI.js';
-import './chunk-GWHGUKAL.js';
+export { Table } from './chunk-42LH2UEM.js';
+import './chunk-NYJGW3XH.js';
 import './chunk-FF7FYGDH.js';
 import './chunk-2WIBY7PZ.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dyno-table",
-  "version": "2.4.0",
+  "version": "2.5.1",
   "description": "A TypeScript library to simplify working with DynamoDB",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -118,16 +118,16 @@
     "url": "git+https://github.com/Kysumi/dyno-table.git"
   },
   "devDependencies": {
-    "@babel/preset-typescript": "^7.26.0",
+    "@babel/preset-typescript": "^7.28.5",
     "@biomejs/biome": "2.2.2",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
-    "@types/node": "^20.17.11",
+    "@types/node": "^20.19.31",
     "husky": "^9.1.7",
     "rimraf": "^5.0.10",
     "semantic-release": "24.2.3",
-    "tsup": "^8.3.5",
-    "typescript": "^5.7.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
     "vitest": "3.0.5"
   },
   "peerDependencies": {