dyno-table 1.6.0 → 1.7.0

package/dist/entity.js

@@ -6,9 +6,55 @@ var createComparisonCondition = (type) => (attr, value) => ({
 });
 var eq = createComparisonCondition("eq");
 
+// src/builders/entity-aware-builders.ts
+function createEntityAwareBuilder(builder, entityName) {
+  return new Proxy(builder, {
+    get(target, prop, receiver) {
+      if (prop === "entityName") {
+        return entityName;
+      }
+      if (prop === "withBatch" && typeof target[prop] === "function") {
+        return (batch, entityType) => {
+          const typeToUse = entityType ?? entityName;
+          const fn = target[prop];
+          return fn.call(target, batch, typeToUse);
+        };
+      }
+      return Reflect.get(target, prop, receiver);
+    }
+  });
+}
+function createEntityAwarePutBuilder(builder, entityName) {
+  return createEntityAwareBuilder(builder, entityName);
+}
+function createEntityAwareGetBuilder(builder, entityName) {
+  return createEntityAwareBuilder(builder, entityName);
+}
+function createEntityAwareDeleteBuilder(builder, entityName) {
+  return createEntityAwareBuilder(builder, entityName);
+}
+
 // src/entity.ts
 function defineEntity(config) {
   const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? "entityType";
+  const wrapMethodWithPreparation = (originalMethod, prepareFn, context) => {
+    const wrappedMethod = (...args) => {
+      prepareFn();
+      return originalMethod.call(context, ...args);
+    };
+    Object.setPrototypeOf(wrappedMethod, originalMethod);
+    const propertyNames = Object.getOwnPropertyNames(originalMethod);
+    for (let i = 0; i < propertyNames.length; i++) {
+      const prop = propertyNames[i];
+      if (prop !== "length" && prop !== "name" && prop !== "prototype") {
+        const descriptor = Object.getOwnPropertyDescriptor(originalMethod, prop);
+        if (descriptor && descriptor.writable !== false && !descriptor.get) {
+          wrappedMethod[prop] = originalMethod[prop];
+        }
+      }
+    }
+    return wrappedMethod;
+  };
   const generateTimestamps = (timestampTypes) => {
     if (!config.settings?.timestamps) return {};
     const timestamps = {};
@@ -113,24 +159,17 @@ function defineEntity(config) {
           };
           const originalWithTransaction = builder.withTransaction;
           if (originalWithTransaction) {
-            const wrappedWithTransaction = (transaction) => {
-              prepareValidatedItemSync();
-              return originalWithTransaction.call(builder, transaction);
-            };
-            Object.setPrototypeOf(wrappedWithTransaction, originalWithTransaction);
-            const propertyNames = Object.getOwnPropertyNames(originalWithTransaction);
-            for (let i = 0; i < propertyNames.length; i++) {
-              const prop = propertyNames[i];
-              if (prop !== "length" && prop !== "name" && prop !== "prototype") {
-                try {
-                  wrappedWithTransaction[prop] = originalWithTransaction[prop];
-                } catch (e) {
-                }
-              }
-            }
-            builder.withTransaction = wrappedWithTransaction;
+            builder.withTransaction = wrapMethodWithPreparation(
+              originalWithTransaction,
+              prepareValidatedItemSync,
+              builder
+            );
           }
-          return builder;
+          const originalWithBatch = builder.withBatch;
+          if (originalWithBatch) {
+            builder.withBatch = wrapMethodWithPreparation(originalWithBatch, prepareValidatedItemSync, builder);
+          }
+          return createEntityAwarePutBuilder(builder, config.name);
         },
         upsert: (data) => {
           const builder = table.put({});
@@ -217,26 +256,19 @@ function defineEntity(config) {
           };
           const originalWithTransaction = builder.withTransaction;
           if (originalWithTransaction) {
-            const wrappedWithTransaction = (transaction) => {
-              prepareValidatedItemSync();
-              return originalWithTransaction.call(builder, transaction);
-            };
-            Object.setPrototypeOf(wrappedWithTransaction, originalWithTransaction);
-            const propertyNames = Object.getOwnPropertyNames(originalWithTransaction);
-            for (let i = 0; i < propertyNames.length; i++) {
-              const prop = propertyNames[i];
-              if (prop !== "length" && prop !== "name" && prop !== "prototype") {
-                try {
-                  wrappedWithTransaction[prop] = originalWithTransaction[prop];
-                } catch (e) {
-                }
-              }
-            }
-            builder.withTransaction = wrappedWithTransaction;
+            builder.withTransaction = wrapMethodWithPreparation(
+              originalWithTransaction,
+              prepareValidatedItemSync,
+              builder
+            );
           }
-          return builder;
+          const originalWithBatch = builder.withBatch;
+          if (originalWithBatch) {
+            builder.withBatch = wrapMethodWithPreparation(originalWithBatch, prepareValidatedItemSync, builder);
+          }
+          return createEntityAwarePutBuilder(builder, config.name);
         },
-        get: (key) => table.get(config.primaryKey.generateKey(key)),
+        get: (key) => createEntityAwareGetBuilder(table.get(config.primaryKey.generateKey(key)), config.name),
         update: (key, data) => {
           const primaryKeyObj = config.primaryKey.generateKey(key);
           const builder = table.update(primaryKeyObj);
@@ -248,13 +280,13 @@ function defineEntity(config) {
         delete: (key) => {
           const builder = table.delete(config.primaryKey.generateKey(key));
           builder.condition(eq(entityTypeAttributeName, config.name));
-          return builder;
+          return createEntityAwareDeleteBuilder(builder, config.name);
         },
         query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {
           acc[key] = (input) => {
             const queryEntity = {
               scan: repository.scan,
-              get: (key2) => table.get(key2),
+              get: (key2) => createEntityAwareGetBuilder(table.get(key2), config.name),
               query: (keyCondition) => {
                 return table.query(keyCondition);
               }

package/dist/entity.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/conditions.ts","../src/entity.ts"],"names":["key"],"mappings":"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","file":"entity.js","sourcesContent":["import type { Path, PathType } from \"./builders/types\";\nimport type { DynamoItem } from \"./types\";\n\n/**\n * Supported comparison operators for DynamoDB conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Comparison Operator Reference}\n *\n * - eq: Equals (=)\n * - ne: Not equals (≠ / <>)\n * - lt: Less than (<)\n * - lte: Less than or equal to (≤)\n * - gt: Greater than (>)\n * - gte: Greater than or equal to (≥)\n * - between: Between two values (inclusive)\n * - in: Checks if attribute value is in a list of values\n * - beginsWith: Checks if string attribute begins with specified substring\n * - contains: Checks if string/set attribute contains specified value\n * - attributeExists: Checks if attribute exists\n * - attributeNotExists: Checks if attribute does not exist\n */\nexport type ComparisonOperator =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"between\"\n  | \"in\"\n  | \"beginsWith\"\n  | \"contains\"\n  | \"attributeExists\"\n  | \"attributeNotExists\";\n\n/**\n * Logical operators for combining multiple conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - Logical Operator Reference}\n *\n * - and: Evaluates to true if all conditions are true\n * - or: Evaluates to true if any condition is true\n * - not: Negate the result of a condition\n */\nexport type LogicalOperator = \"and\" | \"or\" | \"not\";\n\n/**\n * Represents a DynamoDB condition expression.\n * Can be either a comparison condition or a logical combination of conditions.\n *\n * @example\n * // Simple comparison condition\n * const condition: Condition = {\n *   type: \"eq\",\n *   attr: \"status\",\n *   value: \"ACTIVE\"\n * };\n *\n * @example\n * // Logical combination of conditions\n * const condition: Condition = {\n *   type: \"and\",\n *   conditions: [\n *     { type: \"eq\", attr: \"status\", value: \"ACTIVE\" },\n *     { type: \"gt\", attr: \"age\", value: 5 }\n *   ]\n * };\n */\nexport interface Condition {\n  /** The type of condition (comparison or logical operator) */\n  type: ComparisonOperator | LogicalOperator;\n  /** The attribute name for comparison conditions */\n  attr?: string;\n  /** The value to compare against for comparison conditions */\n  value?: unknown;\n  /** Array of conditions for logical operators (and/or) */\n  conditions?: Condition[];\n  /** Single condition for the 'not' operator */\n  condition?: Condition;\n}\n\n/**\n * Parameters used to build DynamoDB expression strings.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html Expression Attribute Names}\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeValues.html Expression Attribute Values}\n */\nexport interface ExpressionParams {\n  /** Map of attribute name placeholders to actual attribute names */\n  expressionAttributeNames: Record<string, string>;\n  /** Map of value placeholders to actual values */\n  expressionAttributeValues: DynamoItem;\n  /** Counter for generating unique value placeholders */\n  valueCounter: { count: number };\n}\n\n/**\n * Creates a comparison condition builder function for the specified operator.\n * @internal\n */\nexport const createComparisonCondition =\n  (type: ComparisonOperator) =>\n  (attr: string, value: unknown): Condition => ({\n    type,\n    attr,\n    value,\n  });\n\n/**\n * Creates an equals (=) condition\n * @example\n * eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const eq = createComparisonCondition(\"eq\");\n\n/**\n * Creates a not equals (≠) condition\n * @example\n * ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const ne = createComparisonCondition(\"ne\");\n\n/**\n * Creates a less than (<) condition\n * @example\n * lt(\"age\", 18) // age < 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lt = createComparisonCondition(\"lt\");\n\n/**\n * Creates a less than or equal to (≤) condition\n * @example\n * lte(\"age\", 18) // age <= 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lte = createComparisonCondition(\"lte\");\n\n/**\n * Creates a greater than (>) condition\n * @example\n * gt(\"price\", 100) // price > 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gt = createComparisonCondition(\"gt\");\n\n/**\n * Creates a greater than or equal to (≥) condition\n * @example\n * gte(\"price\", 100) // price >= 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gte = createComparisonCondition(\"gte\");\n\n/**\n * Creates a between condition that checks if a value is within a range (inclusive)\n * @example\n * between(\"age\", 18, 65) // age BETWEEN 18 AND 65\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n */\nexport const between = (attr: string, lower: unknown, upper: unknown): Condition => ({\n  type: \"between\",\n  attr,\n  value: [lower, upper],\n});\n\n/**\n * Creates an in condition that checks if a value is in a list of values\n * @example\n * inArray(\"status\", [\"ACTIVE\", \"PENDING\", \"PROCESSING\"]) // status IN (\"ACTIVE\", \"PENDING\", \"PROCESSING\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - IN}\n */\nexport const inArray = (attr: string, values: unknown[]): Condition => ({\n  type: \"in\",\n  attr,\n  value: values,\n});\n\n/**\n * Creates a begins_with condition that checks if a string attribute starts with a substring\n * @example\n * beginsWith(\"email\", \"@example.com\") // begins_with(email, \"@example.com\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n */\nexport const beginsWith = createComparisonCondition(\"beginsWith\");\n\n/**\n * Creates a contains condition that checks if a string contains a substring or if a set contains an element\n * @example\n * contains(\"tags\", \"important\") // contains(tags, \"important\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n */\nexport const contains = createComparisonCondition(\"contains\");\n\n/**\n * Creates a condition that checks if an attribute exists\n * @example\n * attributeExists(\"email\") // attribute_exists(email)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n */\nexport const attributeExists = (attr: string): Condition => ({\n  type: \"attributeExists\",\n  attr,\n});\n\n/**\n * Creates a condition that checks if an attribute does not exist\n * @example\n * attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n */\nexport const attributeNotExists = (attr: string): Condition => ({\n  type: \"attributeNotExists\",\n  attr,\n});\n\n// --- Logical Operators ---\n\n/**\n * Combines multiple conditions with AND operator\n * @example\n * and(\n *   eq(\"status\", \"ACTIVE\"),\n *   gt(\"age\", 18)\n * ) // status = \"ACTIVE\" AND age > 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n */\nexport const and = (...conditions: Condition[]): Condition => ({\n  type: \"and\",\n  conditions,\n});\n\n/**\n * Combines multiple conditions with OR operator\n * @example\n * or(\n *   eq(\"status\", \"PENDING\"),\n *   eq(\"status\", \"PROCESSING\")\n * ) // status = \"PENDING\" OR status = \"PROCESSING\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n */\nexport const or = (...conditions: Condition[]): Condition => ({\n  type: \"or\",\n  conditions,\n});\n\n/**\n * Negates a condition\n * @example\n * not(eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n */\nexport const not = (condition: Condition): Condition => ({\n  type: \"not\",\n  condition,\n});\n\n/**\n * Type-safe operators for building key conditions in DynamoDB queries.\n * Only includes operators that are valid for key conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.KeyConditionExpressions AWS DynamoDB - Key Condition Expressions}\n *\n * @example\n * // Using with sort key conditions\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#\")\n * })\n */\nexport type KeyConditionOperator = {\n  /** Equals comparison for key attributes */\n  eq: (value: unknown) => Condition;\n  /** Less than comparison for key attributes */\n  lt: (value: unknown) => Condition;\n  /** Less than or equal comparison for key attributes */\n  lte: (value: unknown) => Condition;\n  /** Greater than comparison for key attributes */\n  gt: (value: unknown) => Condition;\n  /** Greater than or equal comparison for key attributes */\n  gte: (value: unknown) => Condition;\n  /** Between range comparison for key attributes */\n  between: (lower: unknown, upper: unknown) => Condition;\n  /** Begins with comparison for key attributes */\n  beginsWith: (value: unknown) => Condition;\n  /** Combines multiple key conditions with AND */\n  and: (...conditions: Condition[]) => Condition;\n};\n\n/**\n * Type-safe operators for building conditions in DynamoDB operations.\n * Includes all available condition operators with proper type inference.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Condition Expressions}\n *\n * @example\n * // Using with type-safe conditions\n * interface User {\n *   status: string;\n *   age: number;\n *   email?: string;\n * }\n *\n * table.scan<User>()\n *   .where(op => op.and(\n *     op.eq(\"status\", \"ACTIVE\"),\n *     op.gt(\"age\", 18),\n *     op.attributeExists(\"email\")\n *   ))\n *\n * @template T The type of the item being operated on\n */\nexport type ConditionOperator<T extends DynamoItem> = {\n  /**\n   * Creates an equals (=) condition for type-safe attribute comparison.\n   * Tests if the specified attribute equals the provided value.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr equals value\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; age: number; }\n   *\n   * // String comparison\n   * op.eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n   *\n   * // Numeric comparison\n   * op.eq(\"age\", 25) // age = 25\n   *\n   * // Nested attribute\n   * op.eq(\"profile.role\", \"admin\") // profile.role = \"admin\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  eq: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a not equals (≠ / <>) condition for type-safe attribute comparison.\n   * Tests if the specified attribute does not equal the provided value.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr does not equal value\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; priority: number; }\n   *\n   * // String comparison\n   * op.ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n   *\n   * // Numeric comparison\n   * op.ne(\"priority\", 0) // priority <> 0\n   *\n   * // Useful for filtering out specific values\n   * op.ne(\"category\", \"ARCHIVED\") // category <> \"ARCHIVED\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  ne: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a less than (<) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is less than the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is less than value\n   *\n   * @example\n   * ```typescript\n   * interface Product { price: number; name: string; createdAt: string; }\n   *\n   * // Numeric comparison\n   * op.lt(\"price\", 100) // price < 100\n   *\n   * // String comparison (lexicographic)\n   * op.lt(\"name\", \"M\") // name < \"M\" (names starting with A-L)\n   *\n   * // Date comparison (ISO strings)\n   * op.lt(\"createdAt\", \"2024-01-01\") // createdAt < \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  lt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a less than or equal to (≤) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is less than or equal to the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is less than or equal to value\n   *\n   * @example\n   * ```typescript\n   * interface Order { total: number; priority: number; dueDate: string; }\n   *\n   * // Numeric comparison\n   * op.lte(\"total\", 1000) // total <= 1000\n   *\n   * // Priority levels\n   * op.lte(\"priority\", 3) // priority <= 3 (low to medium priority)\n   *\n   * // Date deadlines\n   * op.lte(\"dueDate\", \"2024-12-31\") // dueDate <= \"2024-12-31\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  lte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a greater than (>) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is greater than the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is greater than value\n   *\n   * @example\n   * ```typescript\n   * interface User { age: number; score: number; lastLogin: string; }\n   *\n   * // Age restrictions\n   * op.gt(\"age\", 18) // age > 18 (adults only)\n   *\n   * // Performance thresholds\n   * op.gt(\"score\", 85) // score > 85 (high performers)\n   *\n   * // Recent activity\n   * op.gt(\"lastLogin\", \"2024-01-01\") // lastLogin > \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  gt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a greater than or equal to (≥) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is greater than or equal to the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is greater than or equal to value\n   *\n   * @example\n   * ```typescript\n   * interface Product { rating: number; version: string; releaseDate: string; }\n   *\n   * // Minimum ratings\n   * op.gte(\"rating\", 4.0) // rating >= 4.0 (highly rated)\n   *\n   * // Version requirements\n   * op.gte(\"version\", \"2.0.0\") // version >= \"2.0.0\"\n   *\n   * // Release date filters\n   * op.gte(\"releaseDate\", \"2024-01-01\") // releaseDate >= \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  gte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a between condition for type-safe range comparison.\n   * Tests if the specified attribute value falls within the inclusive range [lower, upper].\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param lower - The lower bound of the range (inclusive, must match attribute type)\n   * @param upper - The upper bound of the range (inclusive, must match attribute type)\n   * @returns A condition that evaluates to true when lower ≤ attr ≤ upper\n   *\n   * @example\n   * ```typescript\n   * interface Event { price: number; date: string; priority: number; }\n   *\n   * // Price range\n   * op.between(\"price\", 50, 200) // price BETWEEN 50 AND 200\n   *\n   * // Date range\n   * op.between(\"date\", \"2024-01-01\", \"2024-12-31\") // date BETWEEN \"2024-01-01\" AND \"2024-12-31\"\n   *\n   * // Priority levels\n   * op.between(\"priority\", 1, 5) // priority BETWEEN 1 AND 5\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n   */\n  between: <K extends Path<T>>(attr: K, lower: PathType<T, K>, upper: PathType<T, K>) => Condition;\n\n  /**\n   * Creates an IN condition for type-safe list membership testing.\n   * Tests if the specified attribute value matches any value in the provided list.\n   * Supports up to 100 values in the list as per DynamoDB limitations.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param values - Array of values to test against (must match attribute type, max 100 items)\n   * @returns A condition that evaluates to true when attr matches any value in the list\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; role: string; priority: number; }\n   *\n   * // Status filtering\n   * op.inArray(\"status\", [\"ACTIVE\", \"PENDING\", \"PROCESSING\"]) // status IN (\"ACTIVE\", \"PENDING\", \"PROCESSING\")\n   *\n   * // Role-based access\n   * op.inArray(\"role\", [\"admin\", \"moderator\", \"editor\"]) // role IN (\"admin\", \"moderator\", \"editor\")\n   *\n   * // Priority levels\n   * op.inArray(\"priority\", [1, 2, 3]) // priority IN (1, 2, 3)\n   * ```\n   *\n   * @throws {Error} When values array is empty or contains more than 100 items\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - IN}\n   */\n  inArray: <K extends Path<T>>(attr: K, values: PathType<T, K>[]) => Condition;\n\n  /**\n   * Creates a begins_with condition for type-safe string prefix testing.\n   * Tests if the specified string attribute starts with the provided substring.\n   * Only works with string attributes - will fail on other data types.\n   *\n   * @param attr - The string attribute path to test (with full type safety)\n   * @param value - The prefix string to test for (must match attribute type)\n   * @returns A condition that evaluates to true when attr starts with value\n   *\n   * @example\n   * ```typescript\n   * interface User { email: string; name: string; id: string; }\n   *\n   * // Email domain filtering\n   * op.beginsWith(\"email\", \"admin@\") // begins_with(email, \"admin@\")\n   *\n   * // Name prefix search\n   * op.beginsWith(\"name\", \"John\") // begins_with(name, \"John\")\n   *\n   * // ID pattern matching\n   * op.beginsWith(\"id\", \"USER#\") // begins_with(id, \"USER#\")\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n   */\n  beginsWith: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a contains condition for type-safe substring or set membership testing.\n   * For strings: tests if the attribute contains the specified substring.\n   * For sets: tests if the set contains the specified element.\n   *\n   * @param attr - The attribute path to test (with full type safety)\n   * @param value - The substring or element to search for (must match attribute type)\n   * @returns A condition that evaluates to true when attr contains value\n   *\n   * @example\n   * ```typescript\n   * interface Post { content: string; tags: Set<string>; categories: string[]; }\n   *\n   * // Substring search in content\n   * op.contains(\"content\", \"important\") // contains(content, \"important\")\n   *\n   * // Tag membership (for DynamoDB String Sets)\n   * op.contains(\"tags\", \"featured\") // contains(tags, \"featured\")\n   *\n   * // Category search (for string arrays stored as lists)\n   * op.contains(\"categories\", \"technology\") // contains(categories, \"technology\")\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n   */\n  contains: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates an attribute_exists condition for type-safe attribute presence testing.\n   * Tests if the specified attribute exists in the item, regardless of its value.\n   * Useful for filtering items that have optional attributes populated.\n   *\n   * @param attr - The attribute path to test for existence (with full type safety)\n   * @returns A condition that evaluates to true when the attribute exists\n   *\n   * @example\n   * ```typescript\n   * interface User { email: string; phone?: string; profile?: { avatar?: string; }; }\n   *\n   * // Check for optional fields\n   * op.attributeExists(\"phone\") // attribute_exists(phone)\n   *\n   * // Check for nested optional attributes\n   * op.attributeExists(\"profile.avatar\") // attribute_exists(profile.avatar)\n   *\n   * // Useful in combination with other conditions\n   * op.and(\n   *   op.eq(\"status\", \"ACTIVE\"),\n   *   op.attributeExists(\"email\") // Only active users with email\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n   */\n  attributeExists: <K extends Path<T>>(attr: K) => Condition;\n\n  /**\n   * Creates an attribute_not_exists condition for type-safe attribute absence testing.\n   * Tests if the specified attribute does not exist in the item.\n   * Useful for conditional writes to prevent overwriting existing data.\n   *\n   * @param attr - The attribute path to test for absence (with full type safety)\n   * @returns A condition that evaluates to true when the attribute does not exist\n   *\n   * @example\n   * ```typescript\n   * interface User { id: string; email: string; deletedAt?: string; }\n   *\n   * // Ensure item hasn't been soft-deleted\n   * op.attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n   *\n   * // Prevent duplicate creation\n   * op.attributeNotExists(\"id\") // attribute_not_exists(id)\n   *\n   * // Conditional updates\n   * op.and(\n   *   op.eq(\"status\", \"PENDING\"),\n   *   op.attributeNotExists(\"processedAt\") // Only unprocessed items\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n   */\n  attributeNotExists: <K extends Path<T>>(attr: K) => Condition;\n\n  /**\n   * Combines multiple conditions with logical AND operator.\n   * All provided conditions must evaluate to true for the AND condition to be true.\n   * Supports any number of conditions as arguments.\n   *\n   * @param conditions - Variable number of conditions to combine with AND\n   * @returns A condition that evaluates to true when all input conditions are true\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; age: number; role: string; verified: boolean; }\n   *\n   * // Multiple criteria\n   * op.and(\n   *   op.eq(\"status\", \"ACTIVE\"),\n   *   op.gt(\"age\", 18),\n   *   op.eq(\"verified\", true)\n   * ) // status = \"ACTIVE\" AND age > 18 AND verified = true\n   *\n   * // Complex business logic\n   * op.and(\n   *   op.inArray(\"role\", [\"admin\", \"moderator\"]),\n   *   op.attributeExists(\"permissions\"),\n   *   op.ne(\"status\", \"SUSPENDED\")\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n   */\n  and: (...conditions: Condition[]) => Condition;\n\n  /**\n   * Combines multiple conditions with logical OR operator.\n   * At least one of the provided conditions must evaluate to true for the OR condition to be true.\n   * Supports any number of conditions as arguments.\n   *\n   * @param conditions - Variable number of conditions to combine with OR\n   * @returns A condition that evaluates to true when any input condition is true\n   *\n   * @example\n   * ```typescript\n   * interface Order { status: string; priority: string; urgent: boolean; }\n   *\n   * // Alternative statuses\n   * op.or(\n   *   op.eq(\"status\", \"PENDING\"),\n   *   op.eq(\"status\", \"PROCESSING\"),\n   *   op.eq(\"status\", \"SHIPPED\")\n   * ) // status = \"PENDING\" OR status = \"PROCESSING\" OR status = \"SHIPPED\"\n   *\n   * // High priority items\n   * op.or(\n   *   op.eq(\"priority\", \"HIGH\"),\n   *   op.eq(\"urgent\", true)\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n   */\n  or: (...conditions: Condition[]) => Condition;\n\n  /**\n   * Negates a condition with logical NOT operator.\n   * Inverts the boolean result of the provided condition.\n   *\n   * @param condition - The condition to negate\n   * @returns A condition that evaluates to true when the input condition is false\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; role: string; banned: boolean; }\n   *\n   * // Exclude specific status\n   * op.not(op.eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n   *\n   * // Complex negation\n   * op.not(\n   *   op.and(\n   *     op.eq(\"role\", \"guest\"),\n   *     op.eq(\"banned\", true)\n   *   )\n   * ) // NOT (role = \"guest\" AND banned = true)\n   *\n   * // Exclude multiple values\n   * op.not(op.inArray(\"status\", [\"DELETED\", \"ARCHIVED\"]))\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n   */\n  not: (condition: Condition) => Condition;\n};\n\n/**\n * Primary key type for QUERY operations.\n * Allows building complex key conditions for the sort key.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html AWS DynamoDB - Query Operations}\n *\n * @example\n * // Query items with a specific partition key and sort key prefix\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#2023\")\n * })\n *\n * @example\n * // Query items within a specific sort key range\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.between(\"ORDER#2023-01\", \"ORDER#2023-12\")\n * })\n */\nexport type PrimaryKey = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key condition builder */\n  sk?: (op: KeyConditionOperator) => Condition;\n};\n\n/**\n * Primary key type for GET and DELETE operations.\n * Used when you need to specify exact key values without conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html AWS DynamoDB - Working with Items}\n *\n * @example\n * // Get a specific item by its complete primary key\n * table.get({\n *   pk: \"USER#123\",\n *   sk: \"PROFILE#123\"\n * })\n *\n * @example\n * // Delete a specific item by its complete primary key\n * table.delete({\n *   pk: \"USER#123\",\n *   sk: \"ORDER#456\"\n * })\n */\nexport type PrimaryKeyWithoutExpression = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key value */\n  sk?: string;\n};\n","import type { DeleteBuilder } from \"./builders/delete-builder\";\nimport type { GetBuilder } from \"./builders/get-builder\";\nimport type { PutBuilder } from \"./builders/put-builder\";\nimport type { ScanBuilder } from \"./builders/scan-builder\";\nimport type { UpdateBuilder } from \"./builders/update-builder\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\nimport type { Table } from \"./table\";\nimport type { DynamoItem, Index, TableConfig } from \"./types\";\nimport { eq, type PrimaryKey, type PrimaryKeyWithoutExpression } from \"./conditions\";\nimport type { QueryBuilder } from \"./builders/query-builder\";\nimport type { TransactionBuilder } from \"./builders/transaction-builder\";\n\n// Define the QueryFunction type with a generic return type\nexport type QueryFunction<T extends DynamoItem, I, R> = (input: I) => R;\n\n// Define a type for the query record that preserves the input type for each query function\nexport type QueryFunctionWithSchema<T extends DynamoItem, I, R> = QueryFunction<T, I, R> & {\n  schema?: StandardSchemaV1<I>;\n};\n\nexport type QueryRecord<T extends DynamoItem> = {\n  // biome-ignore lint/suspicious/noExplicitAny: This is for flexibility\n  [K: string]: QueryFunctionWithSchema<T, any, ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>>;\n};\n\n// Define a type for entity with only scan, get and query methods\nexport type QueryEntity<T extends DynamoItem> = {\n  scan: () => ScanBuilder<T>;\n  get: (key: PrimaryKeyWithoutExpression) => GetBuilder<T>;\n  query: (keyCondition: PrimaryKey) => QueryBuilder<T, TableConfig>;\n};\n\ninterface Settings {\n  /**\n   * Defaults to \"entityType\"\n   */\n  entityTypeAttributeName?: string;\n  timestamps?: {\n    createdAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"createdAt\"\n       */\n      attributeName?: string;\n    };\n    updatedAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"updatedAt\"\n       */\n      attributeName?: string;\n    };\n  };\n}\n\nexport interface EntityConfig<\n  T extends DynamoItem,\n  TInput extends DynamoItem = T,\n  I extends DynamoItem = T,\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  name: string;\n  schema: StandardSchemaV1<TInput, T>;\n  primaryKey: IndexDefinition<I>;\n  indexes?: Record<string, Index>;\n  queries: Q;\n  settings?: Settings;\n}\n\nexport interface EntityRepository<\n  /**\n   * The Entity Type (output type)\n   */\n  T extends DynamoItem,\n  /**\n   * The Input Type (for create operations)\n   */\n  TInput extends DynamoItem = T,\n  /**\n   * The Primary Index (Partition index) Type\n   */\n  I extends DynamoItem = T,\n  /**\n   * The Queries object\n   */\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  create: (data: TInput) => PutBuilder<T>;\n  upsert: (data: TInput & I) => PutBuilder<T>;\n  get: (key: I) => GetBuilder<T>;\n  update: (key: I, data: Partial<T>) => UpdateBuilder<T>;\n  delete: (key: I) => DeleteBuilder;\n  query: Q;\n  scan: () => ScanBuilder<T>;\n}\n\n/**\n * Creates an entity definition with type-safe operations\n *\n * @example\n * ```typescript\n * interface User {\n *   id: string;\n *   name: string;\n * }\n *\n * const UserEntity = defineEntity<User>({\n *   name: \"User\",\n *   schema: userSchema,\n *   primaryKey: primaryKey,\n * });\n * ```\n */\nexport function defineEntity<\n  T extends DynamoItem,\n  TInput extends DynamoItem = T,\n  I extends DynamoItem = T,\n  Q extends QueryRecord<T> = QueryRecord<T>,\n>(config: EntityConfig<T, TInput, I, Q>) {\n  const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? \"entityType\";\n\n  /**\n   * Generates an object containing timestamp attributes based on the given configuration settings.\n   * The function determines the presence and format of \"createdAt\" and \"updatedAt\" timestamps dynamically.\n   *\n   * @param {Array<\"createdAt\" | \"updatedAt\">} [timestampTypes] - Optional array of timestamp types to generate. If not provided, all configured timestamps will be generated.\n   * @returns {Record<string, string | number>} An object containing one or both of the \"createdAt\" and \"updatedAt\" timestamp attributes, depending on the configuration and requested types. Each timestamp can be formatted as either an ISO string or a UNIX timestamp.\n   *\n   * @throws Will not throw errors but depends on `config.settings?.timestamps` to be properly defined.\n   * - If `createdAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.createdAt.attributeName` or defaults to \"createdAt\".\n   * - If `updatedAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.updatedAt.attributeName` or defaults to \"updatedAt\".\n   *\n   * Configuration Details:\n   *  - `config.settings.timestamps.createdAt.format`: Determines the format of the \"createdAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *  - `config.settings.timestamps.updatedAt.format`: Determines the format of the \"updatedAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *\n   * The returned object keys and values depend on the provided configuration and requested timestamp types.\n   */\n  const generateTimestamps = (timestampTypes?: Array<\"createdAt\" | \"updatedAt\">): Record<string, string | number> => {\n    if (!config.settings?.timestamps) return {};\n\n    const timestamps: Record<string, string | number> = {};\n    const now = new Date();\n    const unixTime = Math.floor(Date.now() / 1000);\n\n    const { createdAt, updatedAt } = config.settings.timestamps;\n\n    // If no specific types are provided, generate all configured timestamps\n    const typesToGenerate = timestampTypes || [\"createdAt\", \"updatedAt\"];\n\n    if (createdAt && typesToGenerate.includes(\"createdAt\")) {\n      const name = createdAt.attributeName ?? \"createdAt\";\n      timestamps[name] = createdAt.format === \"UNIX\" ? unixTime : now.toISOString();\n    }\n\n    if (updatedAt && typesToGenerate.includes(\"updatedAt\")) {\n      const name = updatedAt.attributeName ?? \"updatedAt\";\n      timestamps[name] = updatedAt.format === \"UNIX\" ? unixTime : now.toISOString();\n    }\n\n    return timestamps;\n  };\n\n  return {\n    name: config.name,\n    createRepository: (table: Table): EntityRepository<T, TInput, I, Q> => {\n      // Create a repository\n      const repository = {\n        create: (data: TInput) => {\n          // Create a minimal builder without validation or key generation\n          // We'll defer all processing until execute() or withTransaction() is called\n          const builder = table.create<T>({} as T);\n\n          // Core function that handles validation, key generation, and item preparation (async version)\n          const prepareValidatedItemAsync = async () => {\n            // Validate data to ensure defaults are applied before key generation\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case\n            const validatedData = validationResult instanceof Promise ? await validationResult : validationResult;\n\n            if (\"issues\" in validatedData && validatedData.issues) {\n              throw new Error(`Validation failed: ${validatedData.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Generate the primary key using validated data (with defaults applied)\n            const primaryKey = config.primaryKey.generateKey(validatedData.value as unknown as I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validatedData.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              ...(validatedData.value as unknown as T),\n              [entityTypeAttributeName]: config.name,\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Core function that handles validation, key generation, and item preparation (sync version)\n          const prepareValidatedItemSync = () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case - this shouldn't happen for most schemas, but we need to handle it\n            if (validationResult instanceof Promise) {\n              throw new Error(\n                \"Async validation is not supported in create method. The schema must support synchronous validation for transaction compatibility.\",\n              );\n            }\n\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Generate the primary key using validated data (with defaults applied)\n            const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validationResult.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              ...(validationResult.value as unknown as T),\n              [entityTypeAttributeName]: config.name,\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Wrap the builder's execute method\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            await prepareValidatedItemAsync();\n            return await originalExecute.call(builder);\n          };\n\n          // Wrap the builder's withTransaction method\n          const originalWithTransaction = builder.withTransaction;\n          if (originalWithTransaction) {\n            // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n            const wrappedWithTransaction = (transaction: any) => {\n              prepareValidatedItemSync();\n              return originalWithTransaction.call(builder, transaction);\n            };\n\n            // Copy all properties from the original function to preserve mock functionality\n            Object.setPrototypeOf(wrappedWithTransaction, originalWithTransaction);\n            const propertyNames = Object.getOwnPropertyNames(originalWithTransaction);\n            for (let i = 0; i < propertyNames.length; i++) {\n              const prop = propertyNames[i] as string;\n              if (prop !== \"length\" && prop !== \"name\" && prop !== \"prototype\") {\n                try {\n                  // biome-ignore lint/suspicious/noExplicitAny: Make it work\n                  (wrappedWithTransaction as any)[prop] = (originalWithTransaction as any)[prop];\n                } catch (e) {\n                  // Ignore errors for non-configurable properties\n                }\n              }\n            }\n\n            builder.withTransaction = wrappedWithTransaction;\n          }\n\n          return builder;\n        },\n\n        upsert: (data: TInput & I) => {\n          // Create a minimal builder without validation or key generation\n          // We'll defer all processing until execute() or withTransaction() is called\n          const builder = table.put<T>({} as T);\n\n          // Core function that handles validation, key generation, and item preparation (async version)\n          const prepareValidatedItemAsync = async () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case\n            const validatedData = validationResult instanceof Promise ? await validationResult : validationResult;\n\n            if (\"issues\" in validatedData && validatedData.issues) {\n              throw new Error(`Validation failed: ${validatedData.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            const primaryKey = config.primaryKey.generateKey(validatedData.value as unknown as TInput & I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validatedData.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...validatedData.value,\n              [entityTypeAttributeName]: config.name,\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Core function that handles validation, key generation, and item preparation (sync version)\n          const prepareValidatedItemSync = () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case - this shouldn't happen in withTransaction but we need to handle it for type safety\n            if (validationResult instanceof Promise) {\n              throw new Error(\"Async validation is not supported in withTransaction. Use execute() instead.\");\n            }\n\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as TInput & I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validationResult.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...validationResult.value,\n              [entityTypeAttributeName]: config.name,\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Wrap the builder's execute method\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            await prepareValidatedItemAsync();\n            const result = await originalExecute.call(builder);\n            if (!result) {\n              throw new Error(\"Failed to upsert item\");\n            }\n            return result;\n          };\n\n          // Wrap the builder's withTransaction method\n          const originalWithTransaction = builder.withTransaction;\n          if (originalWithTransaction) {\n            const wrappedWithTransaction = (transaction: TransactionBuilder) => {\n              prepareValidatedItemSync();\n              return originalWithTransaction.call(builder, transaction);\n            };\n\n            // Copy all properties from the original function to preserve mock functionality\n            Object.setPrototypeOf(wrappedWithTransaction, originalWithTransaction);\n            const propertyNames = Object.getOwnPropertyNames(originalWithTransaction);\n            for (let i = 0; i < propertyNames.length; i++) {\n              const prop = propertyNames[i] as string;\n              if (prop !== \"length\" && prop !== \"name\" && prop !== \"prototype\") {\n                try {\n                  // biome-ignore lint/suspicious/noExplicitAny: <explanation>\n                  (wrappedWithTransaction as any)[prop] = (originalWithTransaction as any)[prop];\n                } catch (e) {\n                  // Ignore errors for non-configurable properties\n                }\n              }\n            }\n\n            builder.withTransaction = wrappedWithTransaction;\n          }\n\n          return builder;\n        },\n\n        get: <K extends I>(key: K) => table.get<T>(config.primaryKey.generateKey(key)),\n\n        update: <K extends I>(key: K, data: Partial<T>) => {\n          const primaryKeyObj = config.primaryKey.generateKey(key);\n          const builder = table.update<T>(primaryKeyObj);\n          builder.condition(eq(entityTypeAttributeName, config.name));\n\n          // Use only updatedAt timestamp for updates\n          const timestamps = generateTimestamps([\"updatedAt\"]);\n\n          builder.set({ ...data, ...timestamps });\n          return builder;\n        },\n\n        delete: <K extends I>(key: K) => {\n          const builder = table.delete(config.primaryKey.generateKey(key));\n          builder.condition(eq(entityTypeAttributeName, config.name));\n          return builder;\n        },\n\n        query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {\n          // @ts-expect-error - We need to cast the queryFn to a function that takes an unknown input\n          acc[key] = (input: unknown) => {\n            // Create a QueryEntity object with only the necessary methods\n            const queryEntity: QueryEntity<T> = {\n              scan: repository.scan,\n              get: (key: PrimaryKeyWithoutExpression) => table.get<T>(key),\n              query: (keyCondition: PrimaryKey) => {\n                return table.query<T>(keyCondition);\n              },\n            };\n\n            // Execute the query function to get the builder - This type is incorrect and needs to be fixed\n            const queryBuilderCallback = inputCallback(input);\n\n            // Run the inner handler which allows the user to apply their desired contraints\n            // to the query builder of their choice\n            // @ts-expect-error - We need to cast the queryBuilderCallback to a function that takes a QueryEntity\n            const builder = queryBuilderCallback(queryEntity);\n\n            // Add entity type filter if the builder has filter method\n            if (builder && typeof builder === \"object\" && \"filter\" in builder && typeof builder.filter === \"function\") {\n              builder.filter(eq(entityTypeAttributeName, config.name));\n            }\n\n            // Wrap the builder's execute method if it exists\n            if (builder && typeof builder === \"object\" && \"execute\" in builder) {\n              const originalExecute = builder.execute;\n              builder.execute = async () => {\n                // Validate the input before executing the query\n                const queryFn = (\n                  config.queries as unknown as Record<string, QueryFunctionWithSchema<T, I, typeof builder>>\n                )[key];\n\n                if (queryFn && typeof queryFn === \"function\") {\n                  // Get the schema from the query function\n                  const schema = queryFn.schema;\n                  if (schema?.[\"~standard\"]?.validate && typeof schema[\"~standard\"].validate === \"function\") {\n                    const validationResult = schema[\"~standard\"].validate(input);\n                    if (\"issues\" in validationResult && validationResult.issues) {\n                      throw new Error(\n                        `Validation failed: ${validationResult.issues.map((issue) => issue.message).join(\", \")}`,\n                      );\n                    }\n                  }\n                }\n\n                // Execute the original builder\n                const result = await originalExecute.call(builder);\n                if (!result) {\n                  throw new Error(\"Failed to execute query\");\n                }\n                return result;\n              };\n            }\n\n            return builder;\n          };\n          return acc;\n        }, {} as Q),\n\n        scan: () => {\n          const builder = table.scan<T>();\n          builder.filter(eq(entityTypeAttributeName, config.name));\n          return builder;\n        },\n      };\n\n      return repository;\n    },\n  };\n}\n\nexport function createQueries<T extends DynamoItem>() {\n  return {\n    input: <I>(schema: StandardSchemaV1<I>) => ({\n      query: <\n        Q extends QueryRecord<T> = QueryRecord<T>,\n        R = ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>,\n      >(\n        handler: (params: { input: I; entity: QueryEntity<T> }) => R,\n      ) => {\n        const queryFn = (input: I) => (entity: QueryEntity<T>) => handler({ input, entity });\n        queryFn.schema = schema;\n        return queryFn as unknown as QueryFunctionWithSchema<T, I, R>;\n      },\n    }),\n  };\n}\n\nexport interface IndexDefinition<T extends DynamoItem> extends Index {\n  name: string;\n  generateKey: (item: T) => { pk: string; sk?: string };\n}\n\nexport function createIndex() {\n  return {\n    input: <T extends DynamoItem>(schema: StandardSchemaV1<T>) => ({\n      partitionKey: <P extends (item: T) => string>(pkFn: P) => ({\n        sortKey: <S extends (item: T) => string>(skFn: S) =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            sortKey: \"sk\",\n            generateKey: (item: T) => ({ pk: pkFn(item), sk: skFn(item) }),\n          }) as IndexDefinition<T>,\n\n        withoutSortKey: () =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            generateKey: (item: T) => ({ pk: pkFn(item) }),\n          }) as IndexDefinition<T>,\n      }),\n    }),\n  };\n}\n"]}
+{"version":3,"sources":["../src/conditions.ts","../src/builders/entity-aware-builders.ts","../src/entity.ts"],"names":["key"],"mappings":"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","file":"entity.js","sourcesContent":["import type { Path, PathType } from \"./builders/types\";\nimport type { DynamoItem } from \"./types\";\n\n/**\n * Supported comparison operators for DynamoDB conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Comparison Operator Reference}\n *\n * - eq: Equals (=)\n * - ne: Not equals (≠ / <>)\n * - lt: Less than (<)\n * - lte: Less than or equal to (≤)\n * - gt: Greater than (>)\n * - gte: Greater than or equal to (≥)\n * - between: Between two values (inclusive)\n * - in: Checks if attribute value is in a list of values\n * - beginsWith: Checks if string attribute begins with specified substring\n * - contains: Checks if string/set attribute contains specified value\n * - attributeExists: Checks if attribute exists\n * - attributeNotExists: Checks if attribute does not exist\n */\nexport type ComparisonOperator =\n  | \"eq\"\n  | \"ne\"\n  | \"lt\"\n  | \"lte\"\n  | \"gt\"\n  | \"gte\"\n  | \"between\"\n  | \"in\"\n  | \"beginsWith\"\n  | \"contains\"\n  | \"attributeExists\"\n  | \"attributeNotExists\";\n\n/**\n * Logical operators for combining multiple conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - Logical Operator Reference}\n *\n * - and: Evaluates to true if all conditions are true\n * - or: Evaluates to true if any condition is true\n * - not: Negate the result of a condition\n */\nexport type LogicalOperator = \"and\" | \"or\" | \"not\";\n\n/**\n * Represents a DynamoDB condition expression.\n * Can be either a comparison condition or a logical combination of conditions.\n *\n * @example\n * // Simple comparison condition\n * const condition: Condition = {\n *   type: \"eq\",\n *   attr: \"status\",\n *   value: \"ACTIVE\"\n * };\n *\n * @example\n * // Logical combination of conditions\n * const condition: Condition = {\n *   type: \"and\",\n *   conditions: [\n *     { type: \"eq\", attr: \"status\", value: \"ACTIVE\" },\n *     { type: \"gt\", attr: \"age\", value: 5 }\n *   ]\n * };\n */\nexport interface Condition {\n  /** The type of condition (comparison or logical operator) */\n  type: ComparisonOperator | LogicalOperator;\n  /** The attribute name for comparison conditions */\n  attr?: string;\n  /** The value to compare against for comparison conditions */\n  value?: unknown;\n  /** Array of conditions for logical operators (and/or) */\n  conditions?: Condition[];\n  /** Single condition for the 'not' operator */\n  condition?: Condition;\n}\n\n/**\n * Parameters used to build DynamoDB expression strings.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html Expression Attribute Names}\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeValues.html Expression Attribute Values}\n */\nexport interface ExpressionParams {\n  /** Map of attribute name placeholders to actual attribute names */\n  expressionAttributeNames: Record<string, string>;\n  /** Map of value placeholders to actual values */\n  expressionAttributeValues: DynamoItem;\n  /** Counter for generating unique value placeholders */\n  valueCounter: { count: number };\n}\n\n/**\n * Creates a comparison condition builder function for the specified operator.\n * @internal\n */\nexport const createComparisonCondition =\n  (type: ComparisonOperator) =>\n  (attr: string, value: unknown): Condition => ({\n    type,\n    attr,\n    value,\n  });\n\n/**\n * Creates an equals (=) condition\n * @example\n * eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const eq = createComparisonCondition(\"eq\");\n\n/**\n * Creates a not equals (≠) condition\n * @example\n * ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const ne = createComparisonCondition(\"ne\");\n\n/**\n * Creates a less than (<) condition\n * @example\n * lt(\"age\", 18) // age < 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lt = createComparisonCondition(\"lt\");\n\n/**\n * Creates a less than or equal to (≤) condition\n * @example\n * lte(\"age\", 18) // age <= 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lte = createComparisonCondition(\"lte\");\n\n/**\n * Creates a greater than (>) condition\n * @example\n * gt(\"price\", 100) // price > 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gt = createComparisonCondition(\"gt\");\n\n/**\n * Creates a greater than or equal to (≥) condition\n * @example\n * gte(\"price\", 100) // price >= 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gte = createComparisonCondition(\"gte\");\n\n/**\n * Creates a between condition that checks if a value is within a range (inclusive)\n * @example\n * between(\"age\", 18, 65) // age BETWEEN 18 AND 65\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n */\nexport const between = (attr: string, lower: unknown, upper: unknown): Condition => ({\n  type: \"between\",\n  attr,\n  value: [lower, upper],\n});\n\n/**\n * Creates an in condition that checks if a value is in a list of values\n * @example\n * inArray(\"status\", [\"ACTIVE\", \"PENDING\", \"PROCESSING\"]) // status IN (\"ACTIVE\", \"PENDING\", \"PROCESSING\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - IN}\n */\nexport const inArray = (attr: string, values: unknown[]): Condition => ({\n  type: \"in\",\n  attr,\n  value: values,\n});\n\n/**\n * Creates a begins_with condition that checks if a string attribute starts with a substring\n * @example\n * beginsWith(\"email\", \"@example.com\") // begins_with(email, \"@example.com\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n */\nexport const beginsWith = createComparisonCondition(\"beginsWith\");\n\n/**\n * Creates a contains condition that checks if a string contains a substring or if a set contains an element\n * @example\n * contains(\"tags\", \"important\") // contains(tags, \"important\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n */\nexport const contains = createComparisonCondition(\"contains\");\n\n/**\n * Creates a condition that checks if an attribute exists\n * @example\n * attributeExists(\"email\") // attribute_exists(email)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n */\nexport const attributeExists = (attr: string): Condition => ({\n  type: \"attributeExists\",\n  attr,\n});\n\n/**\n * Creates a condition that checks if an attribute does not exist\n * @example\n * attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n */\nexport const attributeNotExists = (attr: string): Condition => ({\n  type: \"attributeNotExists\",\n  attr,\n});\n\n// --- Logical Operators ---\n\n/**\n * Combines multiple conditions with AND operator\n * @example\n * and(\n *   eq(\"status\", \"ACTIVE\"),\n *   gt(\"age\", 18)\n * ) // status = \"ACTIVE\" AND age > 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n */\nexport const and = (...conditions: Condition[]): Condition => ({\n  type: \"and\",\n  conditions,\n});\n\n/**\n * Combines multiple conditions with OR operator\n * @example\n * or(\n *   eq(\"status\", \"PENDING\"),\n *   eq(\"status\", \"PROCESSING\")\n * ) // status = \"PENDING\" OR status = \"PROCESSING\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n */\nexport const or = (...conditions: Condition[]): Condition => ({\n  type: \"or\",\n  conditions,\n});\n\n/**\n * Negates a condition\n * @example\n * not(eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n */\nexport const not = (condition: Condition): Condition => ({\n  type: \"not\",\n  condition,\n});\n\n/**\n * Type-safe operators for building key conditions in DynamoDB queries.\n * Only includes operators that are valid for key conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.KeyConditionExpressions AWS DynamoDB - Key Condition Expressions}\n *\n * @example\n * // Using with sort key conditions\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#\")\n * })\n */\nexport type KeyConditionOperator = {\n  /** Equals comparison for key attributes */\n  eq: (value: unknown) => Condition;\n  /** Less than comparison for key attributes */\n  lt: (value: unknown) => Condition;\n  /** Less than or equal comparison for key attributes */\n  lte: (value: unknown) => Condition;\n  /** Greater than comparison for key attributes */\n  gt: (value: unknown) => Condition;\n  /** Greater than or equal comparison for key attributes */\n  gte: (value: unknown) => Condition;\n  /** Between range comparison for key attributes */\n  between: (lower: unknown, upper: unknown) => Condition;\n  /** Begins with comparison for key attributes */\n  beginsWith: (value: unknown) => Condition;\n  /** Combines multiple key conditions with AND */\n  and: (...conditions: Condition[]) => Condition;\n};\n\n/**\n * Type-safe operators for building conditions in DynamoDB operations.\n * Includes all available condition operators with proper type inference.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Condition Expressions}\n *\n * @example\n * // Using with type-safe conditions\n * interface User {\n *   status: string;\n *   age: number;\n *   email?: string;\n * }\n *\n * table.scan<User>()\n *   .where(op => op.and(\n *     op.eq(\"status\", \"ACTIVE\"),\n *     op.gt(\"age\", 18),\n *     op.attributeExists(\"email\")\n *   ))\n *\n * @template T The type of the item being operated on\n */\nexport type ConditionOperator<T extends DynamoItem> = {\n  /**\n   * Creates an equals (=) condition for type-safe attribute comparison.\n   * Tests if the specified attribute equals the provided value.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr equals value\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; age: number; }\n   *\n   * // String comparison\n   * op.eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n   *\n   * // Numeric comparison\n   * op.eq(\"age\", 25) // age = 25\n   *\n   * // Nested attribute\n   * op.eq(\"profile.role\", \"admin\") // profile.role = \"admin\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  eq: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a not equals (≠ / <>) condition for type-safe attribute comparison.\n   * Tests if the specified attribute does not equal the provided value.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr does not equal value\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; priority: number; }\n   *\n   * // String comparison\n   * op.ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n   *\n   * // Numeric comparison\n   * op.ne(\"priority\", 0) // priority <> 0\n   *\n   * // Useful for filtering out specific values\n   * op.ne(\"category\", \"ARCHIVED\") // category <> \"ARCHIVED\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  ne: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a less than (<) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is less than the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is less than value\n   *\n   * @example\n   * ```typescript\n   * interface Product { price: number; name: string; createdAt: string; }\n   *\n   * // Numeric comparison\n   * op.lt(\"price\", 100) // price < 100\n   *\n   * // String comparison (lexicographic)\n   * op.lt(\"name\", \"M\") // name < \"M\" (names starting with A-L)\n   *\n   * // Date comparison (ISO strings)\n   * op.lt(\"createdAt\", \"2024-01-01\") // createdAt < \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  lt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a less than or equal to (≤) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is less than or equal to the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is less than or equal to value\n   *\n   * @example\n   * ```typescript\n   * interface Order { total: number; priority: number; dueDate: string; }\n   *\n   * // Numeric comparison\n   * op.lte(\"total\", 1000) // total <= 1000\n   *\n   * // Priority levels\n   * op.lte(\"priority\", 3) // priority <= 3 (low to medium priority)\n   *\n   * // Date deadlines\n   * op.lte(\"dueDate\", \"2024-12-31\") // dueDate <= \"2024-12-31\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  lte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a greater than (>) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is greater than the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is greater than value\n   *\n   * @example\n   * ```typescript\n   * interface User { age: number; score: number; lastLogin: string; }\n   *\n   * // Age restrictions\n   * op.gt(\"age\", 18) // age > 18 (adults only)\n   *\n   * // Performance thresholds\n   * op.gt(\"score\", 85) // score > 85 (high performers)\n   *\n   * // Recent activity\n   * op.gt(\"lastLogin\", \"2024-01-01\") // lastLogin > \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  gt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a greater than or equal to (≥) condition for type-safe attribute comparison.\n   * Tests if the specified attribute is greater than or equal to the provided value.\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param value - The value to compare against (must match attribute type)\n   * @returns A condition that evaluates to true when attr is greater than or equal to value\n   *\n   * @example\n   * ```typescript\n   * interface Product { rating: number; version: string; releaseDate: string; }\n   *\n   * // Minimum ratings\n   * op.gte(\"rating\", 4.0) // rating >= 4.0 (highly rated)\n   *\n   * // Version requirements\n   * op.gte(\"version\", \"2.0.0\") // version >= \"2.0.0\"\n   *\n   * // Release date filters\n   * op.gte(\"releaseDate\", \"2024-01-01\") // releaseDate >= \"2024-01-01\"\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - Comparison Operators}\n   */\n  gte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a between condition for type-safe range comparison.\n   * Tests if the specified attribute value falls within the inclusive range [lower, upper].\n   * Works with numbers, strings (lexicographic), and dates.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param lower - The lower bound of the range (inclusive, must match attribute type)\n   * @param upper - The upper bound of the range (inclusive, must match attribute type)\n   * @returns A condition that evaluates to true when lower ≤ attr ≤ upper\n   *\n   * @example\n   * ```typescript\n   * interface Event { price: number; date: string; priority: number; }\n   *\n   * // Price range\n   * op.between(\"price\", 50, 200) // price BETWEEN 50 AND 200\n   *\n   * // Date range\n   * op.between(\"date\", \"2024-01-01\", \"2024-12-31\") // date BETWEEN \"2024-01-01\" AND \"2024-12-31\"\n   *\n   * // Priority levels\n   * op.between(\"priority\", 1, 5) // priority BETWEEN 1 AND 5\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n   */\n  between: <K extends Path<T>>(attr: K, lower: PathType<T, K>, upper: PathType<T, K>) => Condition;\n\n  /**\n   * Creates an IN condition for type-safe list membership testing.\n   * Tests if the specified attribute value matches any value in the provided list.\n   * Supports up to 100 values in the list as per DynamoDB limitations.\n   *\n   * @param attr - The attribute path to compare (with full type safety)\n   * @param values - Array of values to test against (must match attribute type, max 100 items)\n   * @returns A condition that evaluates to true when attr matches any value in the list\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; role: string; priority: number; }\n   *\n   * // Status filtering\n   * op.inArray(\"status\", [\"ACTIVE\", \"PENDING\", \"PROCESSING\"]) // status IN (\"ACTIVE\", \"PENDING\", \"PROCESSING\")\n   *\n   * // Role-based access\n   * op.inArray(\"role\", [\"admin\", \"moderator\", \"editor\"]) // role IN (\"admin\", \"moderator\", \"editor\")\n   *\n   * // Priority levels\n   * op.inArray(\"priority\", [1, 2, 3]) // priority IN (1, 2, 3)\n   * ```\n   *\n   * @throws {Error} When values array is empty or contains more than 100 items\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - IN}\n   */\n  inArray: <K extends Path<T>>(attr: K, values: PathType<T, K>[]) => Condition;\n\n  /**\n   * Creates a begins_with condition for type-safe string prefix testing.\n   * Tests if the specified string attribute starts with the provided substring.\n   * Only works with string attributes - will fail on other data types.\n   *\n   * @param attr - The string attribute path to test (with full type safety)\n   * @param value - The prefix string to test for (must match attribute type)\n   * @returns A condition that evaluates to true when attr starts with value\n   *\n   * @example\n   * ```typescript\n   * interface User { email: string; name: string; id: string; }\n   *\n   * // Email domain filtering\n   * op.beginsWith(\"email\", \"admin@\") // begins_with(email, \"admin@\")\n   *\n   * // Name prefix search\n   * op.beginsWith(\"name\", \"John\") // begins_with(name, \"John\")\n   *\n   * // ID pattern matching\n   * op.beginsWith(\"id\", \"USER#\") // begins_with(id, \"USER#\")\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n   */\n  beginsWith: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates a contains condition for type-safe substring or set membership testing.\n   * For strings: tests if the attribute contains the specified substring.\n   * For sets: tests if the set contains the specified element.\n   *\n   * @param attr - The attribute path to test (with full type safety)\n   * @param value - The substring or element to search for (must match attribute type)\n   * @returns A condition that evaluates to true when attr contains value\n   *\n   * @example\n   * ```typescript\n   * interface Post { content: string; tags: Set<string>; categories: string[]; }\n   *\n   * // Substring search in content\n   * op.contains(\"content\", \"important\") // contains(content, \"important\")\n   *\n   * // Tag membership (for DynamoDB String Sets)\n   * op.contains(\"tags\", \"featured\") // contains(tags, \"featured\")\n   *\n   * // Category search (for string arrays stored as lists)\n   * op.contains(\"categories\", \"technology\") // contains(categories, \"technology\")\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n   */\n  contains: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n\n  /**\n   * Creates an attribute_exists condition for type-safe attribute presence testing.\n   * Tests if the specified attribute exists in the item, regardless of its value.\n   * Useful for filtering items that have optional attributes populated.\n   *\n   * @param attr - The attribute path to test for existence (with full type safety)\n   * @returns A condition that evaluates to true when the attribute exists\n   *\n   * @example\n   * ```typescript\n   * interface User { email: string; phone?: string; profile?: { avatar?: string; }; }\n   *\n   * // Check for optional fields\n   * op.attributeExists(\"phone\") // attribute_exists(phone)\n   *\n   * // Check for nested optional attributes\n   * op.attributeExists(\"profile.avatar\") // attribute_exists(profile.avatar)\n   *\n   * // Useful in combination with other conditions\n   * op.and(\n   *   op.eq(\"status\", \"ACTIVE\"),\n   *   op.attributeExists(\"email\") // Only active users with email\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n   */\n  attributeExists: <K extends Path<T>>(attr: K) => Condition;\n\n  /**\n   * Creates an attribute_not_exists condition for type-safe attribute absence testing.\n   * Tests if the specified attribute does not exist in the item.\n   * Useful for conditional writes to prevent overwriting existing data.\n   *\n   * @param attr - The attribute path to test for absence (with full type safety)\n   * @returns A condition that evaluates to true when the attribute does not exist\n   *\n   * @example\n   * ```typescript\n   * interface User { id: string; email: string; deletedAt?: string; }\n   *\n   * // Ensure item hasn't been soft-deleted\n   * op.attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n   *\n   * // Prevent duplicate creation\n   * op.attributeNotExists(\"id\") // attribute_not_exists(id)\n   *\n   * // Conditional updates\n   * op.and(\n   *   op.eq(\"status\", \"PENDING\"),\n   *   op.attributeNotExists(\"processedAt\") // Only unprocessed items\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n   */\n  attributeNotExists: <K extends Path<T>>(attr: K) => Condition;\n\n  /**\n   * Combines multiple conditions with logical AND operator.\n   * All provided conditions must evaluate to true for the AND condition to be true.\n   * Supports any number of conditions as arguments.\n   *\n   * @param conditions - Variable number of conditions to combine with AND\n   * @returns A condition that evaluates to true when all input conditions are true\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; age: number; role: string; verified: boolean; }\n   *\n   * // Multiple criteria\n   * op.and(\n   *   op.eq(\"status\", \"ACTIVE\"),\n   *   op.gt(\"age\", 18),\n   *   op.eq(\"verified\", true)\n   * ) // status = \"ACTIVE\" AND age > 18 AND verified = true\n   *\n   * // Complex business logic\n   * op.and(\n   *   op.inArray(\"role\", [\"admin\", \"moderator\"]),\n   *   op.attributeExists(\"permissions\"),\n   *   op.ne(\"status\", \"SUSPENDED\")\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n   */\n  and: (...conditions: Condition[]) => Condition;\n\n  /**\n   * Combines multiple conditions with logical OR operator.\n   * At least one of the provided conditions must evaluate to true for the OR condition to be true.\n   * Supports any number of conditions as arguments.\n   *\n   * @param conditions - Variable number of conditions to combine with OR\n   * @returns A condition that evaluates to true when any input condition is true\n   *\n   * @example\n   * ```typescript\n   * interface Order { status: string; priority: string; urgent: boolean; }\n   *\n   * // Alternative statuses\n   * op.or(\n   *   op.eq(\"status\", \"PENDING\"),\n   *   op.eq(\"status\", \"PROCESSING\"),\n   *   op.eq(\"status\", \"SHIPPED\")\n   * ) // status = \"PENDING\" OR status = \"PROCESSING\" OR status = \"SHIPPED\"\n   *\n   * // High priority items\n   * op.or(\n   *   op.eq(\"priority\", \"HIGH\"),\n   *   op.eq(\"urgent\", true)\n   * )\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n   */\n  or: (...conditions: Condition[]) => Condition;\n\n  /**\n   * Negates a condition with logical NOT operator.\n   * Inverts the boolean result of the provided condition.\n   *\n   * @param condition - The condition to negate\n   * @returns A condition that evaluates to true when the input condition is false\n   *\n   * @example\n   * ```typescript\n   * interface User { status: string; role: string; banned: boolean; }\n   *\n   * // Exclude specific status\n   * op.not(op.eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n   *\n   * // Complex negation\n   * op.not(\n   *   op.and(\n   *     op.eq(\"role\", \"guest\"),\n   *     op.eq(\"banned\", true)\n   *   )\n   * ) // NOT (role = \"guest\" AND banned = true)\n   *\n   * // Exclude multiple values\n   * op.not(op.inArray(\"status\", [\"DELETED\", \"ARCHIVED\"]))\n   * ```\n   *\n   * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n   */\n  not: (condition: Condition) => Condition;\n};\n\n/**\n * Primary key type for QUERY operations.\n * Allows building complex key conditions for the sort key.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html AWS DynamoDB - Query Operations}\n *\n * @example\n * // Query items with a specific partition key and sort key prefix\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.beginsWith(\"ORDER#2023\")\n * })\n *\n * @example\n * // Query items within a specific sort key range\n * table.query({\n *   pk: \"USER#123\",\n *   sk: op => op.between(\"ORDER#2023-01\", \"ORDER#2023-12\")\n * })\n */\nexport type PrimaryKey = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key condition builder */\n  sk?: (op: KeyConditionOperator) => Condition;\n};\n\n/**\n * Primary key type for GET and DELETE operations.\n * Used when you need to specify exact key values without conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html AWS DynamoDB - Working with Items}\n *\n * @example\n * // Get a specific item by its complete primary key\n * table.get({\n *   pk: \"USER#123\",\n *   sk: \"PROFILE#123\"\n * })\n *\n * @example\n * // Delete a specific item by its complete primary key\n * table.delete({\n *   pk: \"USER#123\",\n *   sk: \"ORDER#456\"\n * })\n */\nexport type PrimaryKeyWithoutExpression = {\n  /** Partition key value */\n  pk: string;\n  /** Optional sort key value */\n  sk?: string;\n};\n","import type { DynamoItem } from \"../types\";\nimport type { BatchBuilder } from \"./batch-builder\";\nimport type { PutBuilder } from \"./put-builder\";\nimport type { GetBuilder } from \"./get-builder\";\nimport type { DeleteBuilder } from \"./delete-builder\";\n\n/**\n * Creates an entity-aware wrapper that automatically provides entity names to batch operations\n * while transparently delegating all other method calls to the underlying builder.\n */\nfunction createEntityAwareBuilder<T extends object>(\n  builder: T,\n  entityName: string,\n): T & { readonly entityName: string } {\n  return new Proxy(builder, {\n    get(target, prop, receiver) {\n      // Expose the entity name as a readonly property\n      if (prop === \"entityName\") {\n        return entityName;\n      }\n\n      // Intercept withBatch method to provide automatic entity type inference\n      if (prop === \"withBatch\" && typeof (target as Record<string, unknown>)[prop] === \"function\") {\n        return <\n          TEntities extends Record<string, DynamoItem> = Record<string, DynamoItem>,\n          K extends keyof TEntities = keyof TEntities,\n        >(\n          batch: BatchBuilder<TEntities>,\n          entityType?: K,\n        ) => {\n          // Use provided entityType or fall back to stored entityName\n          const typeToUse = entityType ?? (entityName as K);\n          const fn = (target as Record<string, unknown>)[prop] as (\n            batch: BatchBuilder<TEntities>,\n            entityType?: K,\n          ) => unknown;\n          // Call the function with the original target as 'this' context\n          return fn.call(target, batch, typeToUse);\n        };\n      }\n\n      // For all other properties/methods, delegate to the original builder\n      return Reflect.get(target, prop, receiver);\n    },\n  }) as T & { readonly entityName: string };\n}\n\n/**\n * Entity-aware wrapper for PutBuilder that automatically provides entity name to batch operations\n */\nexport type EntityAwarePutBuilder<T extends DynamoItem> = PutBuilder<T> & {\n  readonly entityName: string;\n};\n\n/**\n * Creates an entity-aware PutBuilder\n */\nexport function createEntityAwarePutBuilder<T extends DynamoItem>(\n  builder: PutBuilder<T>,\n  entityName: string,\n): EntityAwarePutBuilder<T> {\n  return createEntityAwareBuilder(builder, entityName);\n}\n\n/**\n * Entity-aware wrapper for GetBuilder that automatically provides entity name to batch operations\n */\nexport type EntityAwareGetBuilder<T extends DynamoItem> = GetBuilder<T> & {\n  readonly entityName: string;\n};\n\n/**\n * Creates an entity-aware GetBuilder\n */\nexport function createEntityAwareGetBuilder<T extends DynamoItem>(\n  builder: GetBuilder<T>,\n  entityName: string,\n): EntityAwareGetBuilder<T> {\n  return createEntityAwareBuilder(builder, entityName);\n}\n\n/**\n * Entity-aware wrapper for DeleteBuilder that automatically provides entity name to batch operations\n */\nexport type EntityAwareDeleteBuilder = DeleteBuilder & {\n  readonly entityName: string;\n};\n\n/**\n * Creates an entity-aware DeleteBuilder\n */\nexport function createEntityAwareDeleteBuilder(builder: DeleteBuilder, entityName: string): EntityAwareDeleteBuilder {\n  return createEntityAwareBuilder(builder, entityName);\n}\n","import type { DeleteBuilder } from \"./builders/delete-builder\";\nimport type { GetBuilder } from \"./builders/get-builder\";\nimport type { PutBuilder } from \"./builders/put-builder\";\nimport type { ScanBuilder } from \"./builders/scan-builder\";\nimport type { UpdateBuilder } from \"./builders/update-builder\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\nimport type { Table } from \"./table\";\nimport type { DynamoItem, Index, TableConfig } from \"./types\";\nimport { eq, type PrimaryKey, type PrimaryKeyWithoutExpression } from \"./conditions\";\nimport type { QueryBuilder } from \"./builders/query-builder\";\nimport type { TransactionBuilder } from \"./builders/transaction-builder\";\nimport {\n  createEntityAwarePutBuilder,\n  createEntityAwareGetBuilder,\n  createEntityAwareDeleteBuilder,\n} from \"./builders/entity-aware-builders\";\nimport type {\n  EntityAwarePutBuilder,\n  EntityAwareGetBuilder,\n  EntityAwareDeleteBuilder,\n} from \"./builders/entity-aware-builders\";\n\n// Define the QueryFunction type with a generic return type\nexport type QueryFunction<T extends DynamoItem, I, R> = (input: I) => R;\n\n// Define a type for the query record that preserves the input type for each query function\nexport type QueryFunctionWithSchema<T extends DynamoItem, I, R> = QueryFunction<T, I, R> & {\n  schema?: StandardSchemaV1<I>;\n};\n\nexport type QueryRecord<T extends DynamoItem> = {\n  // biome-ignore lint/suspicious/noExplicitAny: This is for flexibility\n  [K: string]: QueryFunctionWithSchema<T, any, ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>>;\n};\n\n// Define a type for entity with only scan, get and query methods\nexport type QueryEntity<T extends DynamoItem> = {\n  scan: () => ScanBuilder<T>;\n  get: (key: PrimaryKeyWithoutExpression) => EntityAwareGetBuilder<T>;\n  query: (keyCondition: PrimaryKey) => QueryBuilder<T, TableConfig>;\n};\n\ninterface Settings {\n  /**\n   * Defaults to \"entityType\"\n   */\n  entityTypeAttributeName?: string;\n  timestamps?: {\n    createdAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"createdAt\"\n       */\n      attributeName?: string;\n    };\n    updatedAt?: {\n      /**\n       * ISO vs Unix trade-offs\n       *\n       * Both options support between, greater than and less than comparisons.\n       *\n       * ISO:\n       * - Human readable, but requires more storage space\n       * - Does not work with DynamoDBs TTL feature.\n       *\n       * UNIX:\n       * - Less readable, but requires less storage space.\n       * - Works with DynamoDBs TTL feature.\n       */\n      format: \"ISO\" | \"UNIX\";\n      /**\n       * Defaults to \"updatedAt\"\n       */\n      attributeName?: string;\n    };\n  };\n}\n\nexport interface EntityConfig<\n  T extends DynamoItem,\n  TInput extends DynamoItem = T,\n  I extends DynamoItem = T,\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  name: string;\n  schema: StandardSchemaV1<TInput, T>;\n  primaryKey: IndexDefinition<I>;\n  indexes?: Record<string, Index>;\n  queries: Q;\n  settings?: Settings;\n}\n\nexport interface EntityRepository<\n  /**\n   * The Entity Type (output type)\n   */\n  T extends DynamoItem,\n  /**\n   * The Input Type (for create operations)\n   */\n  TInput extends DynamoItem = T,\n  /**\n   * The Primary Index (Partition index) Type\n   */\n  I extends DynamoItem = T,\n  /**\n   * The Queries object\n   */\n  Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n  create: (data: TInput) => EntityAwarePutBuilder<T>;\n  upsert: (data: TInput & I) => EntityAwarePutBuilder<T>;\n  get: (key: I) => EntityAwareGetBuilder<T>;\n  update: (key: I, data: Partial<T>) => UpdateBuilder<T>;\n  delete: (key: I) => EntityAwareDeleteBuilder;\n  query: Q;\n  scan: () => ScanBuilder<T>;\n}\n\n/**\n * Creates an entity definition with type-safe operations\n *\n * @example\n * ```typescript\n * interface User {\n *   id: string;\n *   name: string;\n * }\n *\n * const UserEntity = defineEntity<User>({\n *   name: \"User\",\n *   schema: userSchema,\n *   primaryKey: primaryKey,\n * });\n * ```\n */\nexport function defineEntity<\n  T extends DynamoItem,\n  TInput extends DynamoItem = T,\n  I extends DynamoItem = T,\n  Q extends QueryRecord<T> = QueryRecord<T>,\n>(config: EntityConfig<T, TInput, I, Q>) {\n  const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? \"entityType\";\n\n  /**\n   * Utility function to wrap a method with preparation logic while preserving all properties\n   * for mock compatibility. This reduces boilerplate for withTransaction and withBatch wrappers.\n   */\n  // biome-ignore lint/suspicious/noExplicitAny: Required for flexible method wrapping\n  const wrapMethodWithPreparation = <TMethod extends (...args: any[]) => any>(\n    originalMethod: TMethod,\n    prepareFn: () => void,\n    // biome-ignore lint/suspicious/noExplicitAny: Required for flexible context binding\n    context: any,\n  ): TMethod => {\n    // biome-ignore lint/suspicious/noExplicitAny: Required for flexible argument handling\n    const wrappedMethod = (...args: any[]) => {\n      prepareFn();\n      return originalMethod.call(context, ...args);\n    };\n\n    // Copy all properties from the original function to preserve mock functionality\n    Object.setPrototypeOf(wrappedMethod, originalMethod);\n    const propertyNames = Object.getOwnPropertyNames(originalMethod);\n    for (let i = 0; i < propertyNames.length; i++) {\n      const prop = propertyNames[i] as string;\n      if (prop !== \"length\" && prop !== \"name\" && prop !== \"prototype\") {\n        // Check if the property is writable before attempting to assign it\n        const descriptor = Object.getOwnPropertyDescriptor(originalMethod, prop);\n        if (descriptor && descriptor.writable !== false && !descriptor.get) {\n          // biome-ignore lint/suspicious/noExplicitAny: meh\n          (wrappedMethod as any)[prop] = (originalMethod as any)[prop];\n        }\n      }\n    }\n\n    return wrappedMethod as TMethod;\n  };\n\n  /**\n   * Generates an object containing timestamp attributes based on the given configuration settings.\n   * The function determines the presence and format of \"createdAt\" and \"updatedAt\" timestamps dynamically.\n   *\n   * @param {Array<\"createdAt\" | \"updatedAt\">} [timestampTypes] - Optional array of timestamp types to generate. If not provided, all configured timestamps will be generated.\n   * @returns {Record<string, string | number>} An object containing one or both of the \"createdAt\" and \"updatedAt\" timestamp attributes, depending on the configuration and requested types. Each timestamp can be formatted as either an ISO string or a UNIX timestamp.\n   *\n   * @throws Will not throw errors but depends on `config.settings?.timestamps` to be properly defined.\n   * - If `createdAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.createdAt.attributeName` or defaults to \"createdAt\".\n   * - If `updatedAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.updatedAt.attributeName` or defaults to \"updatedAt\".\n   *\n   * Configuration Details:\n   *  - `config.settings.timestamps.createdAt.format`: Determines the format of the \"createdAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *  - `config.settings.timestamps.updatedAt.format`: Determines the format of the \"updatedAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n   *\n   * The returned object keys and values depend on the provided configuration and requested timestamp types.\n   */\n  const generateTimestamps = (timestampTypes?: Array<\"createdAt\" | \"updatedAt\">): Record<string, string | number> => {\n    if (!config.settings?.timestamps) return {};\n\n    const timestamps: Record<string, string | number> = {};\n    const now = new Date();\n    const unixTime = Math.floor(Date.now() / 1000);\n\n    const { createdAt, updatedAt } = config.settings.timestamps;\n\n    // If no specific types are provided, generate all configured timestamps\n    const typesToGenerate = timestampTypes || [\"createdAt\", \"updatedAt\"];\n\n    if (createdAt && typesToGenerate.includes(\"createdAt\")) {\n      const name = createdAt.attributeName ?? \"createdAt\";\n      timestamps[name] = createdAt.format === \"UNIX\" ? unixTime : now.toISOString();\n    }\n\n    if (updatedAt && typesToGenerate.includes(\"updatedAt\")) {\n      const name = updatedAt.attributeName ?? \"updatedAt\";\n      timestamps[name] = updatedAt.format === \"UNIX\" ? unixTime : now.toISOString();\n    }\n\n    return timestamps;\n  };\n\n  return {\n    name: config.name,\n    createRepository: (table: Table): EntityRepository<T, TInput, I, Q> => {\n      // Create a repository\n      const repository = {\n        create: (data: TInput) => {\n          // Create a minimal builder without validation or key generation\n          // We'll defer all processing until execute() or withTransaction() is called\n          const builder = table.create<T>({} as T);\n\n          // Core function that handles validation, key generation, and item preparation (async version)\n          const prepareValidatedItemAsync = async () => {\n            // Validate data to ensure defaults are applied before key generation\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case\n            const validatedData = validationResult instanceof Promise ? await validationResult : validationResult;\n\n            if (\"issues\" in validatedData && validatedData.issues) {\n              throw new Error(`Validation failed: ${validatedData.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Generate the primary key using validated data (with defaults applied)\n            const primaryKey = config.primaryKey.generateKey(validatedData.value as unknown as I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validatedData.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              ...(validatedData.value as unknown as T),\n              [entityTypeAttributeName]: config.name,\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Core function that handles validation, key generation, and item preparation (sync version)\n          const prepareValidatedItemSync = () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case - this shouldn't happen for most schemas, but we need to handle it\n            if (validationResult instanceof Promise) {\n              throw new Error(\n                \"Async validation is not supported in create method. The schema must support synchronous validation for transaction compatibility.\",\n              );\n            }\n\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            // Generate the primary key using validated data (with defaults applied)\n            const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validationResult.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              ...(validationResult.value as unknown as T),\n              [entityTypeAttributeName]: config.name,\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Wrap the builder's execute method\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            await prepareValidatedItemAsync();\n            return await originalExecute.call(builder);\n          };\n\n          // Wrap the builder's withTransaction method\n          const originalWithTransaction = builder.withTransaction;\n          if (originalWithTransaction) {\n            builder.withTransaction = wrapMethodWithPreparation(\n              originalWithTransaction,\n              prepareValidatedItemSync,\n              builder,\n            );\n          }\n\n          // Wrap the builder's withBatch method\n          const originalWithBatch = builder.withBatch;\n          if (originalWithBatch) {\n            builder.withBatch = wrapMethodWithPreparation(originalWithBatch, prepareValidatedItemSync, builder);\n          }\n\n          return createEntityAwarePutBuilder(builder, config.name);\n        },\n\n        upsert: (data: TInput & I) => {\n          // Create a minimal builder without validation or key generation\n          // We'll defer all processing until execute() or withTransaction() is called\n          const builder = table.put<T>({} as T);\n\n          // Core function that handles validation, key generation, and item preparation (async version)\n          const prepareValidatedItemAsync = async () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case\n            const validatedData = validationResult instanceof Promise ? await validationResult : validationResult;\n\n            if (\"issues\" in validatedData && validatedData.issues) {\n              throw new Error(`Validation failed: ${validatedData.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            const primaryKey = config.primaryKey.generateKey(validatedData.value as unknown as TInput & I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validatedData.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...validatedData.value,\n              [entityTypeAttributeName]: config.name,\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Core function that handles validation, key generation, and item preparation (sync version)\n          const prepareValidatedItemSync = () => {\n            const validationResult = config.schema[\"~standard\"].validate(data);\n\n            // Handle Promise case - this shouldn't happen in withTransaction but we need to handle it for type safety\n            if (validationResult instanceof Promise) {\n              throw new Error(\"Async validation is not supported in withTransaction. Use execute() instead.\");\n            }\n\n            if (\"issues\" in validationResult && validationResult.issues) {\n              throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n            }\n\n            const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as TInput & I);\n\n            const indexes = Object.entries(config.indexes ?? {}).reduce(\n              (acc, [indexName, index]) => {\n                const key = (index as IndexDefinition<T>).generateKey(validationResult.value as unknown as T);\n                const gsiConfig = table.gsis[indexName];\n\n                if (!gsiConfig) {\n                  throw new Error(`GSI configuration not found for index: ${indexName}`);\n                }\n\n                if (key.pk) {\n                  acc[gsiConfig.partitionKey] = key.pk;\n                }\n                if (key.sk && gsiConfig.sortKey) {\n                  acc[gsiConfig.sortKey] = key.sk;\n                }\n                return acc;\n              },\n              {} as Record<string, string>,\n            );\n\n            const validatedItem = {\n              [table.partitionKey]: primaryKey.pk,\n              ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n              ...validationResult.value,\n              [entityTypeAttributeName]: config.name,\n              ...indexes,\n              ...generateTimestamps([\"createdAt\", \"updatedAt\"]),\n            };\n\n            Object.assign(builder, { item: validatedItem });\n            return validatedItem;\n          };\n\n          // Wrap the builder's execute method\n          const originalExecute = builder.execute;\n          builder.execute = async () => {\n            await prepareValidatedItemAsync();\n            const result = await originalExecute.call(builder);\n            if (!result) {\n              throw new Error(\"Failed to upsert item\");\n            }\n            return result;\n          };\n\n          // Wrap the builder's withTransaction method\n          const originalWithTransaction = builder.withTransaction;\n          if (originalWithTransaction) {\n            builder.withTransaction = wrapMethodWithPreparation(\n              originalWithTransaction,\n              prepareValidatedItemSync,\n              builder,\n            );\n          }\n\n          // Wrap the builder's withBatch method\n          const originalWithBatch = builder.withBatch;\n          if (originalWithBatch) {\n            builder.withBatch = wrapMethodWithPreparation(originalWithBatch, prepareValidatedItemSync, builder);\n          }\n\n          return createEntityAwarePutBuilder(builder, config.name);\n        },\n\n        get: <K extends I>(key: K) =>\n          createEntityAwareGetBuilder(table.get<T>(config.primaryKey.generateKey(key)), config.name),\n\n        update: <K extends I>(key: K, data: Partial<T>) => {\n          const primaryKeyObj = config.primaryKey.generateKey(key);\n          const builder = table.update<T>(primaryKeyObj);\n          builder.condition(eq(entityTypeAttributeName, config.name));\n\n          // Use only updatedAt timestamp for updates\n          const timestamps = generateTimestamps([\"updatedAt\"]);\n\n          builder.set({ ...data, ...timestamps });\n          return builder;\n        },\n\n        delete: <K extends I>(key: K) => {\n          const builder = table.delete(config.primaryKey.generateKey(key));\n          builder.condition(eq(entityTypeAttributeName, config.name));\n          return createEntityAwareDeleteBuilder(builder, config.name);\n        },\n\n        query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {\n          // @ts-expect-error - We need to cast the queryFn to a function that takes an unknown input\n          acc[key] = (input: unknown) => {\n            // Create a QueryEntity object with only the necessary methods\n            const queryEntity: QueryEntity<T> = {\n              scan: repository.scan,\n              get: (key: PrimaryKeyWithoutExpression) => createEntityAwareGetBuilder(table.get<T>(key), config.name),\n              query: (keyCondition: PrimaryKey) => {\n                return table.query<T>(keyCondition);\n              },\n            };\n\n            // Execute the query function to get the builder - This type is incorrect and needs to be fixed\n            const queryBuilderCallback = inputCallback(input);\n\n            // Run the inner handler which allows the user to apply their desired contraints\n            // to the query builder of their choice\n            // @ts-expect-error - We need to cast the queryBuilderCallback to a function that takes a QueryEntity\n            const builder = queryBuilderCallback(queryEntity);\n\n            // Add entity type filter if the builder has filter method\n            if (builder && typeof builder === \"object\" && \"filter\" in builder && typeof builder.filter === \"function\") {\n              builder.filter(eq(entityTypeAttributeName, config.name));\n            }\n\n            // Wrap the builder's execute method if it exists\n            if (builder && typeof builder === \"object\" && \"execute\" in builder) {\n              const originalExecute = builder.execute;\n              builder.execute = async () => {\n                // Validate the input before executing the query\n                const queryFn = (\n                  config.queries as unknown as Record<string, QueryFunctionWithSchema<T, I, typeof builder>>\n                )[key];\n\n                if (queryFn && typeof queryFn === \"function\") {\n                  // Get the schema from the query function\n                  const schema = queryFn.schema;\n                  if (schema?.[\"~standard\"]?.validate && typeof schema[\"~standard\"].validate === \"function\") {\n                    const validationResult = schema[\"~standard\"].validate(input);\n                    if (\"issues\" in validationResult && validationResult.issues) {\n                      throw new Error(\n                        `Validation failed: ${validationResult.issues.map((issue) => issue.message).join(\", \")}`,\n                      );\n                    }\n                  }\n                }\n\n                // Execute the original builder\n                const result = await originalExecute.call(builder);\n                if (!result) {\n                  throw new Error(\"Failed to execute query\");\n                }\n                return result;\n              };\n            }\n\n            return builder;\n          };\n          return acc;\n        }, {} as Q),\n\n        scan: () => {\n          const builder = table.scan<T>();\n          builder.filter(eq(entityTypeAttributeName, config.name));\n          return builder;\n        },\n      };\n\n      return repository;\n    },\n  };\n}\n\nexport function createQueries<T extends DynamoItem>() {\n  return {\n    input: <I>(schema: StandardSchemaV1<I>) => ({\n      query: <\n        Q extends QueryRecord<T> = QueryRecord<T>,\n        R = ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>,\n      >(\n        handler: (params: { input: I; entity: QueryEntity<T> }) => R,\n      ) => {\n        const queryFn = (input: I) => (entity: QueryEntity<T>) => handler({ input, entity });\n        queryFn.schema = schema;\n        return queryFn as unknown as QueryFunctionWithSchema<T, I, R>;\n      },\n    }),\n  };\n}\n\nexport interface IndexDefinition<T extends DynamoItem> extends Index {\n  name: string;\n  generateKey: (item: T) => { pk: string; sk?: string };\n}\n\nexport function createIndex() {\n  return {\n    input: <T extends DynamoItem>(schema: StandardSchemaV1<T>) => ({\n      partitionKey: <P extends (item: T) => string>(pkFn: P) => ({\n        sortKey: <S extends (item: T) => string>(skFn: S) =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            sortKey: \"sk\",\n            generateKey: (item: T) => ({ pk: pkFn(item), sk: skFn(item) }),\n          }) as IndexDefinition<T>,\n\n        withoutSortKey: () =>\n          ({\n            name: \"custom\",\n            partitionKey: \"pk\",\n            generateKey: (item: T) => ({ pk: pkFn(item) }),\n          }) as IndexDefinition<T>,\n      }),\n    }),\n  };\n}\n"]}