dyno-table 1.6.0 → 1.7.0

package/dist/builders/update-builder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/conditions.ts","../../src/expression.ts","../../src/utils/debug-expression.ts","../../src/builders/update-builder.ts"],"names":["value"],"mappings":"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","file":"update-builder.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 { ComparisonOperator, Condition, ExpressionParams, LogicalOperator } from \"./conditions\";\n\nexport const generateAttributeName = (params: ExpressionParams, attr: string): string => {\n  // Check if the attribute already exists in the expressionAttributeNames\n  for (const [existingName, existingAttr] of Object.entries(params.expressionAttributeNames)) {\n    if (existingAttr === attr) {\n      return existingName;\n    }\n  }\n\n  // If not found, create a new attribute name\n  const attrName = `#${Object.keys(params.expressionAttributeNames).length}`;\n  params.expressionAttributeNames[attrName] = attr;\n  return attrName;\n};\n\nexport const generateValueName = (params: ExpressionParams, value: unknown): string => {\n  const valueName = `:${params.valueCounter.count++}`;\n  params.expressionAttributeValues[valueName] = value;\n  return valueName;\n};\n\nconst validateCondition = (condition: Condition, requiresAttr = true, requiresValue = true): void => {\n  if (requiresAttr && !condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (requiresValue && condition.value === undefined) {\n    throw new Error(`Value is required for ${condition.type} condition`);\n  }\n};\n\nconst buildComparisonExpression = (condition: Condition, operator: string, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueName = generateValueName(params, condition.value);\n\n  return `${attrName} ${operator} ${valueName}`;\n};\n\nconst buildBetweenExpression = (condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (!Array.isArray(condition.value) || condition.value.length !== 2) {\n    throw new Error(\"Between condition requires an array of two values\");\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const lowerName = generateValueName(params, condition.value[0]);\n  const upperName = generateValueName(params, condition.value[1]);\n\n  return `${attrName} BETWEEN ${lowerName} AND ${upperName}`;\n};\n\nconst buildInExpression = (condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (!Array.isArray(condition.value) || condition.value.length === 0) {\n    throw new Error(\"In condition requires a non-empty array of values\");\n  }\n\n  if (condition.value.length > 100) {\n    throw new Error(\"In condition supports a maximum of 100 values\");\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueNames = condition.value.map((value) => generateValueName(params, value));\n\n  return `${attrName} IN (${valueNames.join(\", \")})`;\n};\n\nconst buildFunctionExpression = (functionName: string, condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueName = generateValueName(params, condition.value);\n\n  return `${functionName}(${attrName}, ${valueName})`;\n};\n\nconst buildAttributeFunction = (functionName: string, condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition, true, false);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  return `${functionName}(${attrName})`;\n};\n\nconst buildLogicalExpression = (operator: string, conditions: Condition[], params: ExpressionParams): string => {\n  if (!conditions || conditions.length === 0) {\n    throw new Error(`At least one condition is required for ${operator} expression`);\n  }\n\n  const expressions = conditions.map((c) => buildExpression(c, params));\n  return `(${expressions.join(` ${operator} `)})`;\n};\n\nexport const buildExpression = (condition: Condition, params: ExpressionParams): string => {\n  if (!condition) return \"\";\n\n  try {\n    // Map of condition types to their expression builders\n    const expressionBuilders: Record<ComparisonOperator | LogicalOperator, () => string> = {\n      eq: () => buildComparisonExpression(condition, \"=\", params),\n      ne: () => buildComparisonExpression(condition, \"<>\", params),\n      lt: () => buildComparisonExpression(condition, \"<\", params),\n      lte: () => buildComparisonExpression(condition, \"<=\", params),\n      gt: () => buildComparisonExpression(condition, \">\", params),\n      gte: () => buildComparisonExpression(condition, \">=\", params),\n      between: () => buildBetweenExpression(condition, params),\n      in: () => buildInExpression(condition, params),\n      beginsWith: () => buildFunctionExpression(\"begins_with\", condition, params),\n      contains: () => buildFunctionExpression(\"contains\", condition, params),\n      attributeExists: () => buildAttributeFunction(\"attribute_exists\", condition, params),\n      attributeNotExists: () => buildAttributeFunction(\"attribute_not_exists\", condition, params),\n      and: () => {\n        if (!condition.conditions) {\n          throw new Error(\"Conditions array is required for AND operator\");\n        }\n        return buildLogicalExpression(\"AND\", condition.conditions, params);\n      },\n      or: () => {\n        if (!condition.conditions) {\n          throw new Error(\"Conditions array is required for OR operator\");\n        }\n        return buildLogicalExpression(\"OR\", condition.conditions, params);\n      },\n      not: () => {\n        if (!condition.condition) {\n          throw new Error(\"Condition is required for NOT operator\");\n        }\n        return `NOT (${buildExpression(condition.condition, params)})`;\n      },\n    };\n\n    const builder = expressionBuilders[condition.type];\n    if (!builder) {\n      throw new Error(`Unknown condition type: ${condition.type}`);\n    }\n\n    return builder();\n  } catch (error: unknown) {\n    if (error instanceof Error) {\n      console.error(`Error building expression for condition type ${condition.type}:`, error.message);\n    } else {\n      console.error(`Error building expression for condition type ${condition.type}:`, error);\n    }\n    throw error;\n  }\n};\n\nexport const prepareExpressionParams = (\n  condition?: Condition,\n): {\n  expression?: string;\n  names?: Record<string, string>;\n  values?: Record<string, unknown>;\n} => {\n  if (!condition) return {};\n\n  const params: ExpressionParams = {\n    expressionAttributeNames: {},\n    expressionAttributeValues: {},\n    valueCounter: { count: 0 },\n  };\n\n  const expression = buildExpression(condition, params);\n\n  return {\n    expression,\n    names: Object.keys(params.expressionAttributeNames).length > 0 ? params.expressionAttributeNames : undefined,\n    values: Object.keys(params.expressionAttributeValues).length > 0 ? params.expressionAttributeValues : undefined,\n  };\n};\n","/**\n * Interface for DynamoDB command objects that can contain expressions\n */\nexport interface DynamoCommandWithExpressions {\n  conditionExpression?: string;\n  updateExpression?: string;\n  filterExpression?: string;\n  keyConditionExpression?: string;\n  projectionExpression?: string;\n  expressionAttributeNames?: Record<string, string>;\n  expressionAttributeValues?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\ntype ReadableDynamoCommand = {\n  conditionExpression?: string;\n  updateExpression?: string;\n  filterExpression?: string;\n  keyConditionExpression?: string;\n  projectionExpression?: string;\n};\n\n/**\n * Utility function to debug a DynamoDB command by replacing all placeholders\n * in expressions with their actual values.\n *\n * @param command Any DynamoDB command with expressions and attribute maps\n * @returns An object with the same structure but with readable expressions\n */\nexport function debugCommand<T extends DynamoCommandWithExpressions>(\n  command: T,\n): {\n  raw: T;\n  readable: ReadableDynamoCommand;\n} {\n  // Create a copy of the command\n  const result: ReadableDynamoCommand = {};\n\n  function replaceAliases(expressionString: string) {\n    if (!expressionString) {\n      return expressionString;\n    }\n\n    let replacedString = expressionString;\n    for (const alias in command.expressionAttributeNames) {\n      const attributeName = command.expressionAttributeNames[alias];\n      const regex = new RegExp(alias, \"g\");\n\n      replacedString = replacedString.replace(regex, attributeName as string);\n    }\n\n    for (const alias in command.expressionAttributeValues) {\n      let attributeValue = command.expressionAttributeValues[alias];\n\n      // Handle Set objects for better readability\n      if (attributeValue instanceof Set) {\n        const array = Array.from(attributeValue);\n        attributeValue = `Set(${array.length}){${array.map((v) => JSON.stringify(v)).join(\", \")}}`;\n      } else {\n        // Stringify other values for display\n        attributeValue = JSON.stringify(attributeValue);\n      }\n\n      const regex = new RegExp(alias, \"g\");\n      replacedString = replacedString.replace(regex, attributeValue as string);\n    }\n\n    return replacedString;\n  }\n\n  if (command.updateExpression) {\n    result.updateExpression = replaceAliases(command.updateExpression);\n  }\n  if (command.conditionExpression) {\n    result.conditionExpression = replaceAliases(command.conditionExpression);\n  }\n  if (command.filterExpression) {\n    result.filterExpression = replaceAliases(command.filterExpression);\n  }\n  if (command.keyConditionExpression) {\n    result.keyConditionExpression = replaceAliases(command.keyConditionExpression);\n  }\n  if (command.projectionExpression) {\n    result.projectionExpression = replaceAliases(command.projectionExpression);\n  }\n\n  return {\n    raw: command,\n    readable: result,\n  };\n}\n","import type { Condition, ConditionOperator, PrimaryKeyWithoutExpression } from \"../conditions\";\nimport {\n  eq,\n  ne,\n  lt,\n  lte,\n  gt,\n  gte,\n  between,\n  inArray,\n  beginsWith,\n  contains,\n  attributeExists,\n  attributeNotExists,\n  and,\n  or,\n  not,\n} from \"../conditions\";\nimport type { Path, PathType } from \"./types\";\nimport type { TransactionBuilder } from \"./transaction-builder\";\nimport { buildExpression, generateAttributeName, generateValueName } from \"../expression\";\nimport { debugCommand } from \"../utils/debug-expression\";\nimport type { UpdateCommandParams } from \"./builder-types\";\nimport type { DynamoItem } from \"../types\";\n\n/**\n * Configuration options for DynamoDB update operations.\n */\nexport interface UpdateOptions {\n  /** Optional condition that must be satisfied for the update to succeed */\n  condition?: Condition;\n  /** Determines which item attributes to include in the response */\n  returnValues?: \"ALL_NEW\" | \"UPDATED_NEW\" | \"ALL_OLD\" | \"UPDATED_OLD\" | \"NONE\";\n}\n\n/**\n * Function type for executing DynamoDB update operations.\n * @typeParam T - The type of the item being updated\n */\ntype UpdateExecutor<T extends DynamoItem> = (params: UpdateCommandParams) => Promise<{ item?: T }>;\n\n/**\n * Represents a single update action within an update operation.\n * Each action modifies the item in a specific way:\n * - SET: Modify or add attributes\n * - REMOVE: Delete attributes\n * - ADD: Update numbers and sets\n * - DELETE: Remove elements from a set\n */\nexport type UpdateAction = {\n  /** The type of update action */\n  type: \"SET\" | \"REMOVE\" | \"ADD\" | \"DELETE\";\n  /** The attribute path to update */\n  path: string;\n  /** The value to use in the update (not used for REMOVE actions) */\n  value?: unknown;\n};\n\n/**\n * Type utility to get the element type of a set.\n * Extracts the element type from either a Set or Array type.\n * @typeParam T - The set or array type\n */\ntype SetElementType<T> = T extends Set<infer U> ? U : T extends Array<infer U> ? U : never;\n\n/**\n * Type utility to get the element type from a path that points to a set.\n * Combines PathType and SetElementType to get the element type at a specific path.\n * @typeParam T - The type of the item\n * @typeParam K - The path within the item\n */\ntype PathSetElementType<T, K extends Path<T>> = SetElementType<PathType<T, K>>;\n\n/**\n * Builder for creating DynamoDB update operations.\n *\n * The builder supports all DynamoDB update operations:\n * - SET: Modify or add attributes\n * - REMOVE: Delete attributes\n * - ADD: Update numbers and sets\n * - DELETE: Remove elements from a set\n *\n * @example\n * ```typescript\n * // Simple update\n * const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n *   .set('status', 'HUNTING')\n *   .set('lastFed', new Date().toISOString())\n *   .execute();\n *\n * // Complex update with multiple operations\n * const result = await new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })\n *   .set({\n *     status: 'OCCUPIED',\n *     occupants: 3,\n *     'metadata.lastInspection': new Date().toISOString()\n *   })\n *   .add('securityBreaches', 1)\n *   .deleteElementsFromSet('suitableDinosaurs', ['VELOCIRAPTOR'])\n *   .condition(op => op.gt('securityLevel', 8))\n *   .returnValues('ALL_NEW')\n *   .execute();\n * ```\n *\n * @typeParam T - The type of item being updated\n */\nexport class UpdateBuilder<T extends DynamoItem> {\n  private updates: UpdateAction[] = [];\n  private options: UpdateOptions = {\n    returnValues: \"ALL_NEW\",\n  };\n  private readonly executor: UpdateExecutor<T>;\n  private readonly tableName: string;\n  private readonly key: PrimaryKeyWithoutExpression;\n\n  constructor(executor: UpdateExecutor<T>, tableName: string, key: PrimaryKeyWithoutExpression) {\n    this.executor = executor;\n    this.tableName = tableName;\n    this.key = key;\n  }\n\n  /**\n   * Sets multiple attributes of an item using an object.\n   *\n   * @example\n   * ```typescript\n   * // Update multiple attributes\n   * builder.set({\n   *   species: 'Tyrannosaurus Rex',\n   *   height: 20,\n   *   diet: 'CARNIVORE',\n   *   'stats.threatLevel': 10\n   * });\n   * ```\n   */\n  set(values: Partial<T>): UpdateBuilder<T>;\n\n  /**\n   * Sets a single attribute to a specific value.\n   *\n   * @example\n   * ```typescript\n   * // Set simple attributes\n   * builder\n   *   .set('status', 'SLEEPING')\n   *   .set('lastFeeding', new Date().toISOString());\n   *\n   * // Set nested attributes\n   * builder\n   *   .set('location.zone', 'RESTRICTED')\n   *   .set('stats.health', 100);\n   * ```\n   */\n  set<K extends Path<T>>(path: K, value: PathType<T, K>): UpdateBuilder<T>;\n  set<K extends Path<T>>(valuesOrPath: K | Partial<T>, value?: PathType<T, K>): this {\n    if (typeof valuesOrPath === \"object\") {\n      for (const [key, value] of Object.entries(valuesOrPath)) {\n        this.updates.push({\n          type: \"SET\",\n          path: key,\n          value,\n        });\n      }\n    } else {\n      this.updates.push({\n        type: \"SET\",\n        path: valuesOrPath,\n        value,\n      });\n    }\n\n    return this;\n  }\n\n  /**\n   * Removes an attribute from the item.\n   *\n   * @example\n   * ```typescript\n   * // Remove simple attributes\n   * builder\n   *   .remove('temporaryTag')\n   *   .remove('previousLocation');\n   *\n   * // Remove nested attributes\n   * builder\n   *   .remove('metadata.testData')\n   *   .remove('stats.experimentalMetrics');\n   * ```\n   *\n   * @param path - The path to the attribute to remove\n   * @returns The builder instance for method chaining\n   */\n  remove<K extends Path<T>>(path: K): this {\n    this.updates.push({\n      type: \"REMOVE\",\n      path,\n    });\n    return this;\n  }\n\n  /**\n   * Adds a value to a number attribute or adds elements to a set.\n   *\n   * @example\n   * ```typescript\n   * // Increment counters\n   * builder\n   *   .add('escapeAttempts', 1)\n   *   .add('feedingCount', 1);\n   *\n   * // Add to sets\n   * builder\n   *   .add('knownBehaviors', new Set(['PACK_HUNTING', 'AMBUSH_TACTICS']))\n   *   .add('visitedZones', new Set(['ZONE_A', 'ZONE_B']));\n   * ```\n   *\n   * @param path - The path to the attribute to update\n   * @param value - The value to add (number or set)\n   * @returns The builder instance for method chaining\n   */\n  add<K extends Path<T>>(path: K, value: PathType<T, K>): this {\n    this.updates.push({\n      type: \"ADD\",\n      path,\n      value,\n    });\n    return this;\n  }\n\n  /**\n   * Removes elements from a set attribute.\n   *\n   * @example\n   * ```typescript\n   * // Remove from sets using arrays\n   * builder.deleteElementsFromSet(\n   *   'allowedHabitats',\n   *   ['JUNGLE', 'COASTAL']\n   * );\n   *\n   * // Remove from sets using Set DynamoItems\n   * builder.deleteElementsFromSet(\n   *   'knownBehaviors',\n   *   new Set(['NOCTURNAL', 'TERRITORIAL'])\n   * );\n   *\n   * // Remove from nested sets\n   * builder.deleteElementsFromSet(\n   *   'stats.compatibleSpecies',\n   *   ['VELOCIRAPTOR', 'DILOPHOSAURUS']\n   * );\n   * ```\n   *\n   * @param path - The path to the set attribute\n   * @param value - Elements to remove (array or Set)\n   * @returns The builder instance for method chaining\n   */\n  deleteElementsFromSet<K extends Path<T>>(\n    path: K,\n    value: PathSetElementType<T, K>[] | Set<PathSetElementType<T, K>>,\n  ): this {\n    let valuesToDelete: Set<PathSetElementType<T, K>>;\n\n    if (Array.isArray(value)) {\n      valuesToDelete = new Set(value);\n    } else {\n      valuesToDelete = value;\n    }\n\n    this.updates.push({\n      type: \"DELETE\",\n      path,\n      value: valuesToDelete,\n    });\n    return this;\n  }\n\n  /**\n   * Adds a condition that must be satisfied for the update to succeed.\n   *\n   * @example\n   * ```typescript\n   * // Simple condition\n   * builder.condition(op =>\n   *   op.eq('status', 'ACTIVE')\n   * );\n   *\n   * // Health check condition\n   * builder.condition(op =>\n   *   op.and([\n   *     op.gt('health', 50),\n   *     op.eq('status', 'HUNTING')\n   *   ])\n   * );\n   *\n   * // Complex security condition\n   * builder.condition(op =>\n   *   op.and([\n   *     op.attributeExists('securitySystem'),\n   *     op.eq('containmentStatus', 'SECURE'),\n   *     op.lt('aggressionLevel', 8)\n   *   ])\n   * );\n   *\n   * // Version check (optimistic locking)\n   * builder.condition(op =>\n   *   op.eq('version', currentVersion)\n   * );\n   * ```\n   *\n   * @param condition - Either a Condition DynamoItem or a callback function that builds the condition\n   * @returns The builder instance for method chaining\n   */\n  condition(condition: Condition | ((op: ConditionOperator<T>) => Condition)): this {\n    if (typeof condition === \"function\") {\n      const conditionOperator: ConditionOperator<T> = {\n        eq,\n        ne,\n        lt,\n        lte,\n        gt,\n        gte,\n        between,\n        inArray,\n        beginsWith,\n        contains,\n        attributeExists,\n        attributeNotExists,\n        and,\n        or,\n        not,\n      };\n      this.options.condition = condition(conditionOperator);\n    } else {\n      this.options.condition = condition;\n    }\n    return this;\n  }\n\n  /**\n   * Sets which item attributes to include in the response.\n   *\n   * Available options:\n   * - ALL_NEW: All attributes after the update\n   * - UPDATED_NEW: Only updated attributes, new values\n   * - ALL_OLD: All attributes before the update\n   * - UPDATED_OLD: Only updated attributes, old values\n   * - NONE: No attributes returned (default)\n   *\n   * @example\n   * ```typescript\n   * // Get complete updated dinosaur\n   * const result = await builder\n   *   .set('status', 'SLEEPING')\n   *   .returnValues('ALL_NEW')\n   *   .execute();\n   *\n   * // Track specific attribute changes\n   * const result = await builder\n   *   .set({\n   *     'stats.health': 100,\n   *     'stats.energy': 95\n   *   })\n   *   .returnValues('UPDATED_OLD')\n   *   .execute();\n   *\n   * if (result.item) {\n   *   console.log('Previous health:', result.item.stats?.health);\n   * }\n   * ```\n   *\n   * @param returnValues - Which attributes to return in the response\n   * @returns The builder instance for method chaining\n   */\n  returnValues(returnValues: \"ALL_NEW\" | \"UPDATED_NEW\" | \"ALL_OLD\" | \"UPDATED_OLD\" | \"NONE\"): this {\n    this.options.returnValues = returnValues;\n    return this;\n  }\n\n  /**\n   * Generate the DynamoDB command parameters\n   */\n  toDynamoCommand(): UpdateCommandParams {\n    if (this.updates.length === 0) {\n      throw new Error(\"No update actions specified\");\n    }\n\n    const expressionParams: {\n      expressionAttributeNames: Record<string, string>;\n      expressionAttributeValues: DynamoItem;\n      valueCounter: { count: number };\n    } = {\n      expressionAttributeNames: {},\n      expressionAttributeValues: {},\n      valueCounter: { count: 0 },\n    };\n\n    // Build the update expression\n    let updateExpression = \"\";\n\n    // Group updates by type\n    const setUpdates: UpdateAction[] = [];\n    const removeUpdates: UpdateAction[] = [];\n    const addUpdates: UpdateAction[] = [];\n    const deleteUpdates: UpdateAction[] = [];\n\n    for (const update of this.updates) {\n      switch (update.type) {\n        case \"SET\":\n          setUpdates.push(update);\n          break;\n        case \"REMOVE\":\n          removeUpdates.push(update);\n          break;\n        case \"ADD\":\n          addUpdates.push(update);\n          break;\n        case \"DELETE\":\n          deleteUpdates.push(update);\n          break;\n      }\n    }\n\n    // Build SET clause\n    if (setUpdates.length > 0) {\n      updateExpression += \"SET \";\n      updateExpression += setUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n          expressionParams.expressionAttributeValues[valueName] = update.value;\n          return `${attrName} = ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build REMOVE clause\n    if (removeUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n      updateExpression += \"REMOVE \";\n      updateExpression += removeUpdates\n        .map((update) => {\n          return generateAttributeName(expressionParams, update.path);\n        })\n        .join(\", \");\n    }\n\n    // Build ADD clause\n    if (addUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n      updateExpression += \"ADD \";\n      updateExpression += addUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n\n          return `${attrName} ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build DELETE clause\n    if (deleteUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n\n      updateExpression += \"DELETE \";\n      updateExpression += deleteUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n\n          return `${attrName} ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build condition expression if provided\n    let conditionExpression: string | undefined;\n    if (this.options.condition) {\n      conditionExpression = buildExpression(this.options.condition, expressionParams);\n    }\n\n    const { expressionAttributeNames, expressionAttributeValues } = expressionParams;\n\n    return {\n      tableName: this.tableName,\n      key: this.key,\n      updateExpression,\n      conditionExpression,\n      expressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : undefined,\n      expressionAttributeValues:\n        Object.keys(expressionAttributeValues).length > 0 ? expressionAttributeValues : undefined,\n      returnValues: this.options.returnValues,\n    };\n  }\n\n  /**\n   * Adds this update operation to a transaction.\n   *\n   * @example\n   * ```typescript\n   * const transaction = new TransactionBuilder(executor);\n   *\n   * // Update dinosaur status and habitat occupancy atomically\n   * new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n   *   .set('location', 'PADDOCK_A')\n   *   .set('status', 'CONTAINED')\n   *   .withTransaction(transaction);\n   *\n   * new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })\n   *   .add('occupants', 1)\n   *   .set('lastOccupied', new Date().toISOString())\n   *   .withTransaction(transaction);\n   *\n   * // Execute all operations atomically\n   * await transaction.execute();\n   * ```\n   *\n   * @param transaction - The transaction builder to add this operation to\n   * @returns The builder instance for method chaining\n   */\n  withTransaction(transaction: TransactionBuilder) {\n    const command = this.toDynamoCommand();\n    transaction.updateWithCommand(command);\n  }\n\n  /**\n   * Gets a human-readable representation of the update command.\n   *\n   * @example\n   * ```typescript\n   * // Create complex update\n   * const builder = new UpdateBuilder(executor, 'dinosaurs', { id: 'RAPTOR-001' })\n   *   .set({\n   *     status: 'HUNTING',\n   *     'stats.health': 95,\n   *     'behavior.lastObserved': new Date().toISOString()\n   *   })\n   *   .add('huntingSuccesses', 1)\n   *   .condition(op => op.gt('health', 50));\n   *\n   * // Debug the update\n   * const debugInfo = builder.debug();\n   * console.log('Update operation:', debugInfo);\n   * ```\n   *\n   * @returns A readable representation of the update command with resolved expressions\n   */\n  debug(): DynamoItem {\n    const command = this.toDynamoCommand();\n    return debugCommand(command);\n  }\n\n  /**\n   * Executes the update operation against DynamoDB.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   // Update dinosaur status with conditions\n   *   const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n   *     .set({\n   *       status: 'FEEDING',\n   *       lastMeal: new Date().toISOString(),\n   *       'stats.hunger': 0\n   *     })\n   *     .add('feedingCount', 1)\n   *     .condition(op =>\n   *       op.and([\n   *         op.gt('stats.hunger', 80),\n   *         op.eq('status', 'HUNTING')\n   *       ])\n   *     )\n   *     .returnValues('ALL_NEW')\n   *     .execute();\n   *\n   *   if (result.item) {\n   *     console.log('Updated dinosaur:', result.item);\n   *   }\n   * } catch (error) {\n   *   // Handle condition check failure\n   *   console.error('Failed to update dinosaur:', error);\n   *   // Check if dinosaur wasn't hungry enough\n   *   if (error.name === 'ConditionalCheckFailedException') {\n   *     console.log('Dinosaur not ready for feeding');\n   *   }\n   * }\n   * ```\n   *\n   * @returns A promise that resolves to an DynamoItem containing the updated item (if returnValues is set)\n   * @throws {ConditionalCheckFailedException} If the condition check fails\n   * @throws {Error} If the update operation fails for other reasons\n   */\n  async execute(): Promise<{ item?: T }> {\n    const params = this.toDynamoCommand();\n    return this.executor(params);\n  }\n}\n"]}
+{"version":3,"sources":["../../src/conditions.ts","../../src/expression.ts","../../src/utils/debug-expression.ts","../../src/builders/update-builder.ts"],"names":["value"],"mappings":"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","file":"update-builder.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 { ComparisonOperator, Condition, ExpressionParams, LogicalOperator } from \"./conditions\";\n\nexport const generateAttributeName = (params: ExpressionParams, attr: string): string => {\n  // Check if the attribute already exists in the expressionAttributeNames\n  for (const [existingName, existingAttr] of Object.entries(params.expressionAttributeNames)) {\n    if (existingAttr === attr) {\n      return existingName;\n    }\n  }\n\n  // If not found, create a new attribute name\n  const attrName = `#${Object.keys(params.expressionAttributeNames).length}`;\n  params.expressionAttributeNames[attrName] = attr;\n  return attrName;\n};\n\nexport const generateValueName = (params: ExpressionParams, value: unknown): string => {\n  const valueName = `:${params.valueCounter.count++}`;\n  params.expressionAttributeValues[valueName] = value;\n  return valueName;\n};\n\nconst validateCondition = (condition: Condition, requiresAttr = true, requiresValue = true): void => {\n  if (requiresAttr && !condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (requiresValue && condition.value === undefined) {\n    throw new Error(`Value is required for ${condition.type} condition`);\n  }\n};\n\nconst buildComparisonExpression = (condition: Condition, operator: string, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueName = generateValueName(params, condition.value);\n\n  return `${attrName} ${operator} ${valueName}`;\n};\n\nconst buildBetweenExpression = (condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (!Array.isArray(condition.value) || condition.value.length !== 2) {\n    throw new Error(\"Between condition requires an array of two values\");\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const lowerName = generateValueName(params, condition.value[0]);\n  const upperName = generateValueName(params, condition.value[1]);\n\n  return `${attrName} BETWEEN ${lowerName} AND ${upperName}`;\n};\n\nconst buildInExpression = (condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  if (!Array.isArray(condition.value) || condition.value.length === 0) {\n    throw new Error(\"In condition requires a non-empty array of values\");\n  }\n\n  if (condition.value.length > 100) {\n    throw new Error(\"In condition supports a maximum of 100 values\");\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueNames = condition.value.map((value) => generateValueName(params, value));\n\n  return `${attrName} IN (${valueNames.join(\", \")})`;\n};\n\nconst buildFunctionExpression = (functionName: string, condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  const valueName = generateValueName(params, condition.value);\n\n  return `${functionName}(${attrName}, ${valueName})`;\n};\n\nconst buildAttributeFunction = (functionName: string, condition: Condition, params: ExpressionParams): string => {\n  validateCondition(condition, true, false);\n\n  if (!condition.attr) {\n    throw new Error(`Attribute is required for ${condition.type} condition`);\n  }\n\n  const attrName = generateAttributeName(params, condition.attr);\n  return `${functionName}(${attrName})`;\n};\n\nconst buildLogicalExpression = (operator: string, conditions: Condition[], params: ExpressionParams): string => {\n  if (!conditions || conditions.length === 0) {\n    throw new Error(`At least one condition is required for ${operator} expression`);\n  }\n\n  const expressions = conditions.map((c) => buildExpression(c, params));\n  return `(${expressions.join(` ${operator} `)})`;\n};\n\nexport const buildExpression = (condition: Condition, params: ExpressionParams): string => {\n  if (!condition) return \"\";\n\n  try {\n    // Map of condition types to their expression builders\n    const expressionBuilders: Record<ComparisonOperator | LogicalOperator, () => string> = {\n      eq: () => buildComparisonExpression(condition, \"=\", params),\n      ne: () => buildComparisonExpression(condition, \"<>\", params),\n      lt: () => buildComparisonExpression(condition, \"<\", params),\n      lte: () => buildComparisonExpression(condition, \"<=\", params),\n      gt: () => buildComparisonExpression(condition, \">\", params),\n      gte: () => buildComparisonExpression(condition, \">=\", params),\n      between: () => buildBetweenExpression(condition, params),\n      in: () => buildInExpression(condition, params),\n      beginsWith: () => buildFunctionExpression(\"begins_with\", condition, params),\n      contains: () => buildFunctionExpression(\"contains\", condition, params),\n      attributeExists: () => buildAttributeFunction(\"attribute_exists\", condition, params),\n      attributeNotExists: () => buildAttributeFunction(\"attribute_not_exists\", condition, params),\n      and: () => {\n        if (!condition.conditions) {\n          throw new Error(\"Conditions array is required for AND operator\");\n        }\n        return buildLogicalExpression(\"AND\", condition.conditions, params);\n      },\n      or: () => {\n        if (!condition.conditions) {\n          throw new Error(\"Conditions array is required for OR operator\");\n        }\n        return buildLogicalExpression(\"OR\", condition.conditions, params);\n      },\n      not: () => {\n        if (!condition.condition) {\n          throw new Error(\"Condition is required for NOT operator\");\n        }\n        return `NOT (${buildExpression(condition.condition, params)})`;\n      },\n    };\n\n    const builder = expressionBuilders[condition.type];\n    if (!builder) {\n      throw new Error(`Unknown condition type: ${condition.type}`);\n    }\n\n    return builder();\n  } catch (error: unknown) {\n    if (error instanceof Error) {\n      console.error(`Error building expression for condition type ${condition.type}:`, error.message);\n    } else {\n      console.error(`Error building expression for condition type ${condition.type}:`, error);\n    }\n    throw error;\n  }\n};\n\nexport const prepareExpressionParams = (\n  condition?: Condition,\n): {\n  expression?: string;\n  names?: Record<string, string>;\n  values?: Record<string, unknown>;\n} => {\n  if (!condition) return {};\n\n  const params: ExpressionParams = {\n    expressionAttributeNames: {},\n    expressionAttributeValues: {},\n    valueCounter: { count: 0 },\n  };\n\n  const expression = buildExpression(condition, params);\n\n  return {\n    expression,\n    names: Object.keys(params.expressionAttributeNames).length > 0 ? params.expressionAttributeNames : undefined,\n    values: Object.keys(params.expressionAttributeValues).length > 0 ? params.expressionAttributeValues : undefined,\n  };\n};\n","/**\n * Interface for DynamoDB command objects that can contain expressions\n */\nexport interface DynamoCommandWithExpressions {\n  conditionExpression?: string;\n  updateExpression?: string;\n  filterExpression?: string;\n  keyConditionExpression?: string;\n  projectionExpression?: string;\n  expressionAttributeNames?: Record<string, string>;\n  expressionAttributeValues?: Record<string, unknown>;\n  [key: string]: unknown;\n}\n\ntype ReadableDynamoCommand = {\n  conditionExpression?: string;\n  updateExpression?: string;\n  filterExpression?: string;\n  keyConditionExpression?: string;\n  projectionExpression?: string;\n};\n\n/**\n * Utility function to debug a DynamoDB command by replacing all placeholders\n * in expressions with their actual values.\n *\n * @param command Any DynamoDB command with expressions and attribute maps\n * @returns An object with the same structure but with readable expressions\n */\nexport function debugCommand<T extends DynamoCommandWithExpressions>(\n  command: T,\n): {\n  raw: T;\n  readable: ReadableDynamoCommand;\n} {\n  // Create a copy of the command\n  const result: ReadableDynamoCommand = {};\n\n  function replaceAliases(expressionString: string) {\n    if (!expressionString) {\n      return expressionString;\n    }\n\n    let replacedString = expressionString;\n    for (const alias in command.expressionAttributeNames) {\n      const attributeName = command.expressionAttributeNames[alias];\n      const regex = new RegExp(alias, \"g\");\n\n      replacedString = replacedString.replace(regex, attributeName as string);\n    }\n\n    for (const alias in command.expressionAttributeValues) {\n      let attributeValue = command.expressionAttributeValues[alias];\n\n      // Handle Set objects for better readability\n      if (attributeValue instanceof Set) {\n        const array = Array.from(attributeValue);\n        attributeValue = `Set(${array.length}){${array.map((v) => JSON.stringify(v)).join(\", \")}}`;\n      } else {\n        // Stringify other values for display\n        attributeValue = JSON.stringify(attributeValue);\n      }\n\n      const regex = new RegExp(alias, \"g\");\n      replacedString = replacedString.replace(regex, attributeValue as string);\n    }\n\n    return replacedString;\n  }\n\n  if (command.updateExpression) {\n    result.updateExpression = replaceAliases(command.updateExpression);\n  }\n  if (command.conditionExpression) {\n    result.conditionExpression = replaceAliases(command.conditionExpression);\n  }\n  if (command.filterExpression) {\n    result.filterExpression = replaceAliases(command.filterExpression);\n  }\n  if (command.keyConditionExpression) {\n    result.keyConditionExpression = replaceAliases(command.keyConditionExpression);\n  }\n  if (command.projectionExpression) {\n    result.projectionExpression = replaceAliases(command.projectionExpression);\n  }\n\n  return {\n    raw: command,\n    readable: result,\n  };\n}\n","import type { Condition, ConditionOperator, PrimaryKeyWithoutExpression } from \"../conditions\";\nimport {\n  eq,\n  ne,\n  lt,\n  lte,\n  gt,\n  gte,\n  between,\n  inArray,\n  beginsWith,\n  contains,\n  attributeExists,\n  attributeNotExists,\n  and,\n  or,\n  not,\n} from \"../conditions\";\nimport type { Path, PathType } from \"./types\";\nimport type { TransactionBuilder } from \"./transaction-builder\";\nimport { buildExpression, generateAttributeName, generateValueName } from \"../expression\";\nimport { debugCommand } from \"../utils/debug-expression\";\nimport type { UpdateCommandParams } from \"./builder-types\";\nimport type { DynamoItem } from \"../types\";\n\n/**\n * Configuration options for DynamoDB update operations.\n */\nexport interface UpdateOptions {\n  /** Optional condition that must be satisfied for the update to succeed */\n  condition?: Condition;\n  /** Determines which item attributes to include in the response */\n  returnValues?: \"ALL_NEW\" | \"UPDATED_NEW\" | \"ALL_OLD\" | \"UPDATED_OLD\" | \"NONE\";\n}\n\n/**\n * Function type for executing DynamoDB update operations.\n * @typeParam T - The type of the item being updated\n */\ntype UpdateExecutor<T extends DynamoItem> = (params: UpdateCommandParams) => Promise<{ item?: T }>;\n\n/**\n * Represents a single update action within an update operation.\n * Each action modifies the item in a specific way:\n * - SET: Modify or add attributes\n * - REMOVE: Delete attributes\n * - ADD: Update numbers and sets\n * - DELETE: Remove elements from a set\n */\nexport type UpdateAction = {\n  /** The type of update action */\n  type: \"SET\" | \"REMOVE\" | \"ADD\" | \"DELETE\";\n  /** The attribute path to update */\n  path: string;\n  /** The value to use in the update (not used for REMOVE actions) */\n  value?: unknown;\n};\n\n/**\n * Type utility to get the element type of a set.\n * Extracts the element type from either a Set or Array type.\n * @typeParam T - The set or array type\n */\ntype SetElementType<T> = T extends Set<infer U> ? U : T extends Array<infer U> ? U : never;\n\n/**\n * Type utility to get the element type from a path that points to a set.\n * Combines PathType and SetElementType to get the element type at a specific path.\n * @typeParam T - The type of the item\n * @typeParam K - The path within the item\n */\ntype PathSetElementType<T, K extends Path<T>> = SetElementType<PathType<T, K>>;\n\n/**\n * Builder for creating DynamoDB update operations.\n *\n * The builder supports all DynamoDB update operations:\n * - SET: Modify or add attributes\n * - REMOVE: Delete attributes\n * - ADD: Update numbers and sets\n * - DELETE: Remove elements from a set\n *\n * @example\n * ```typescript\n * // Simple update\n * const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n *   .set('status', 'HUNTING')\n *   .set('lastFed', new Date().toISOString())\n *   .execute();\n *\n * // Complex update with multiple operations\n * const result = await new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })\n *   .set({\n *     status: 'OCCUPIED',\n *     occupants: 3,\n *     'metadata.lastInspection': new Date().toISOString()\n *   })\n *   .add('securityBreaches', 1)\n *   .deleteElementsFromSet('suitableDinosaurs', ['VELOCIRAPTOR'])\n *   .condition(op => op.gt('securityLevel', 8))\n *   .returnValues('ALL_NEW')\n *   .execute();\n * ```\n *\n * @typeParam T - The type of item being updated\n */\nexport class UpdateBuilder<T extends DynamoItem> {\n  private updates: UpdateAction[] = [];\n  private options: UpdateOptions = {\n    returnValues: \"ALL_NEW\",\n  };\n  private readonly executor: UpdateExecutor<T>;\n  private readonly tableName: string;\n  private readonly key: PrimaryKeyWithoutExpression;\n\n  constructor(executor: UpdateExecutor<T>, tableName: string, key: PrimaryKeyWithoutExpression) {\n    this.executor = executor;\n    this.tableName = tableName;\n    this.key = key;\n  }\n\n  /**\n   * Sets multiple attributes of an item using an object.\n   *\n   * @example\n   * ```typescript\n   * // Update multiple attributes\n   * builder.set({\n   *   species: 'Tyrannosaurus Rex',\n   *   height: 20,\n   *   diet: 'CARNIVORE',\n   *   'stats.threatLevel': 10\n   * });\n   * ```\n   */\n  set(values: Partial<T>): UpdateBuilder<T>;\n\n  /**\n   * Sets a single attribute to a specific value.\n   *\n   * @example\n   * ```typescript\n   * // Set simple attributes\n   * builder\n   *   .set('status', 'SLEEPING')\n   *   .set('lastFeeding', new Date().toISOString());\n   *\n   * // Set nested attributes\n   * builder\n   *   .set('location.zone', 'RESTRICTED')\n   *   .set('stats.health', 100);\n   * ```\n   */\n  set<K extends Path<T>>(path: K, value: PathType<T, K>): UpdateBuilder<T>;\n  set<K extends Path<T>>(valuesOrPath: K | Partial<T>, value?: PathType<T, K>): this {\n    if (typeof valuesOrPath === \"object\") {\n      for (const [key, value] of Object.entries(valuesOrPath)) {\n        this.updates.push({\n          type: \"SET\",\n          path: key,\n          value,\n        });\n      }\n    } else {\n      this.updates.push({\n        type: \"SET\",\n        path: valuesOrPath,\n        value,\n      });\n    }\n\n    return this;\n  }\n\n  /**\n   * Removes an attribute from the item.\n   *\n   * @example\n   * ```typescript\n   * // Remove simple attributes\n   * builder\n   *   .remove('temporaryTag')\n   *   .remove('previousLocation');\n   *\n   * // Remove nested attributes\n   * builder\n   *   .remove('metadata.testData')\n   *   .remove('stats.experimentalMetrics');\n   * ```\n   *\n   * @param path - The path to the attribute to remove\n   * @returns The builder instance for method chaining\n   */\n  remove<K extends Path<T>>(path: K): this {\n    this.updates.push({\n      type: \"REMOVE\",\n      path,\n    });\n    return this;\n  }\n\n  /**\n   * Adds a value to a number attribute or adds elements to a set.\n   *\n   * @example\n   * ```typescript\n   * // Increment counters\n   * builder\n   *   .add('escapeAttempts', 1)\n   *   .add('feedingCount', 1);\n   *\n   * // Add to sets\n   * builder\n   *   .add('knownBehaviors', new Set(['PACK_HUNTING', 'AMBUSH_TACTICS']))\n   *   .add('visitedZones', new Set(['ZONE_A', 'ZONE_B']));\n   * ```\n   *\n   * @param path - The path to the attribute to update\n   * @param value - The value to add (number or set)\n   * @returns The builder instance for method chaining\n   */\n  add<K extends Path<T>>(path: K, value: PathType<T, K>): this {\n    this.updates.push({\n      type: \"ADD\",\n      path,\n      value,\n    });\n    return this;\n  }\n\n  /**\n   * Removes elements from a set attribute.\n   *\n   * @example\n   * ```typescript\n   * // Remove from sets using arrays\n   * builder.deleteElementsFromSet(\n   *   'allowedHabitats',\n   *   ['JUNGLE', 'COASTAL']\n   * );\n   *\n   * // Remove from sets using Set DynamoItems\n   * builder.deleteElementsFromSet(\n   *   'knownBehaviors',\n   *   new Set(['NOCTURNAL', 'TERRITORIAL'])\n   * );\n   *\n   * // Remove from nested sets\n   * builder.deleteElementsFromSet(\n   *   'stats.compatibleSpecies',\n   *   ['VELOCIRAPTOR', 'DILOPHOSAURUS']\n   * );\n   * ```\n   *\n   * @param path - The path to the set attribute\n   * @param value - Elements to remove (array or Set)\n   * @returns The builder instance for method chaining\n   */\n  deleteElementsFromSet<K extends Path<T>>(\n    path: K,\n    value: PathSetElementType<T, K>[] | Set<PathSetElementType<T, K>>,\n  ): this {\n    let valuesToDelete: Set<PathSetElementType<T, K>>;\n\n    if (Array.isArray(value)) {\n      valuesToDelete = new Set(value);\n    } else {\n      valuesToDelete = value;\n    }\n\n    this.updates.push({\n      type: \"DELETE\",\n      path,\n      value: valuesToDelete,\n    });\n    return this;\n  }\n\n  /**\n   * Adds a condition that must be satisfied for the update to succeed.\n   *\n   * @example\n   * ```typescript\n   * // Simple condition\n   * builder.condition(op =>\n   *   op.eq('status', 'ACTIVE')\n   * );\n   *\n   * // Health check condition\n   * builder.condition(op =>\n   *   op.and([\n   *     op.gt('health', 50),\n   *     op.eq('status', 'HUNTING')\n   *   ])\n   * );\n   *\n   * // Complex security condition\n   * builder.condition(op =>\n   *   op.and([\n   *     op.attributeExists('securitySystem'),\n   *     op.eq('containmentStatus', 'SECURE'),\n   *     op.lt('aggressionLevel', 8)\n   *   ])\n   * );\n   *\n   * // Version check (optimistic locking)\n   * builder.condition(op =>\n   *   op.eq('version', currentVersion)\n   * );\n   * ```\n   *\n   * @param condition - Either a Condition DynamoItem or a callback function that builds the condition\n   * @returns The builder instance for method chaining\n   */\n  condition(condition: Condition | ((op: ConditionOperator<T>) => Condition)): this {\n    if (typeof condition === \"function\") {\n      const conditionOperator: ConditionOperator<T> = {\n        eq,\n        ne,\n        lt,\n        lte,\n        gt,\n        gte,\n        between,\n        inArray,\n        beginsWith,\n        contains,\n        attributeExists,\n        attributeNotExists,\n        and,\n        or,\n        not,\n      };\n      this.options.condition = condition(conditionOperator);\n    } else {\n      this.options.condition = condition;\n    }\n    return this;\n  }\n\n  /**\n   * Sets which item attributes to include in the response.\n   *\n   * Available options:\n   * - ALL_NEW: All attributes after the update (default)\n   * - UPDATED_NEW: Only updated attributes, new values\n   * - ALL_OLD: All attributes before the update\n   * - UPDATED_OLD: Only updated attributes, old values\n   * - NONE: No attributes returned\n   *\n   * @example\n   * ```typescript\n   * // Get complete updated dinosaur\n   * const result = await builder\n   *   .set('status', 'SLEEPING')\n   *   .returnValues('ALL_NEW')\n   *   .execute();\n   *\n   * // Track specific attribute changes\n   * const result = await builder\n   *   .set({\n   *     'stats.health': 100,\n   *     'stats.energy': 95\n   *   })\n   *   .returnValues('UPDATED_OLD')\n   *   .execute();\n   *\n   * if (result.item) {\n   *   console.log('Previous health:', result.item.stats?.health);\n   * }\n   * ```\n   *\n   * @param returnValues - Which attributes to return in the response\n   * @returns The builder instance for method chaining\n   */\n  returnValues(returnValues: \"ALL_NEW\" | \"UPDATED_NEW\" | \"ALL_OLD\" | \"UPDATED_OLD\" | \"NONE\"): this {\n    this.options.returnValues = returnValues;\n    return this;\n  }\n\n  /**\n   * Generate the DynamoDB command parameters\n   */\n  toDynamoCommand(): UpdateCommandParams {\n    if (this.updates.length === 0) {\n      throw new Error(\"No update actions specified\");\n    }\n\n    const expressionParams: {\n      expressionAttributeNames: Record<string, string>;\n      expressionAttributeValues: DynamoItem;\n      valueCounter: { count: number };\n    } = {\n      expressionAttributeNames: {},\n      expressionAttributeValues: {},\n      valueCounter: { count: 0 },\n    };\n\n    // Build the update expression\n    let updateExpression = \"\";\n\n    // Group updates by type\n    const setUpdates: UpdateAction[] = [];\n    const removeUpdates: UpdateAction[] = [];\n    const addUpdates: UpdateAction[] = [];\n    const deleteUpdates: UpdateAction[] = [];\n\n    for (const update of this.updates) {\n      switch (update.type) {\n        case \"SET\":\n          setUpdates.push(update);\n          break;\n        case \"REMOVE\":\n          removeUpdates.push(update);\n          break;\n        case \"ADD\":\n          addUpdates.push(update);\n          break;\n        case \"DELETE\":\n          deleteUpdates.push(update);\n          break;\n      }\n    }\n\n    // Build SET clause\n    if (setUpdates.length > 0) {\n      updateExpression += \"SET \";\n      updateExpression += setUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n          expressionParams.expressionAttributeValues[valueName] = update.value;\n          return `${attrName} = ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build REMOVE clause\n    if (removeUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n      updateExpression += \"REMOVE \";\n      updateExpression += removeUpdates\n        .map((update) => {\n          return generateAttributeName(expressionParams, update.path);\n        })\n        .join(\", \");\n    }\n\n    // Build ADD clause\n    if (addUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n      updateExpression += \"ADD \";\n      updateExpression += addUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n\n          return `${attrName} ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build DELETE clause\n    if (deleteUpdates.length > 0) {\n      if (updateExpression) {\n        updateExpression += \" \";\n      }\n\n      updateExpression += \"DELETE \";\n      updateExpression += deleteUpdates\n        .map((update) => {\n          const attrName = generateAttributeName(expressionParams, update.path);\n          const valueName = generateValueName(expressionParams, update.value);\n\n          return `${attrName} ${valueName}`;\n        })\n        .join(\", \");\n    }\n\n    // Build condition expression if provided\n    let conditionExpression: string | undefined;\n    if (this.options.condition) {\n      conditionExpression = buildExpression(this.options.condition, expressionParams);\n    }\n\n    const { expressionAttributeNames, expressionAttributeValues } = expressionParams;\n\n    return {\n      tableName: this.tableName,\n      key: this.key,\n      updateExpression,\n      conditionExpression,\n      expressionAttributeNames: Object.keys(expressionAttributeNames).length > 0 ? expressionAttributeNames : undefined,\n      expressionAttributeValues:\n        Object.keys(expressionAttributeValues).length > 0 ? expressionAttributeValues : undefined,\n      returnValues: this.options.returnValues,\n    };\n  }\n\n  /**\n   * Adds this update operation to a transaction.\n   *\n   * @example\n   * ```typescript\n   * const transaction = new TransactionBuilder(executor);\n   *\n   * // Update dinosaur status and habitat occupancy atomically\n   * new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n   *   .set('location', 'PADDOCK_A')\n   *   .set('status', 'CONTAINED')\n   *   .withTransaction(transaction);\n   *\n   * new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })\n   *   .add('occupants', 1)\n   *   .set('lastOccupied', new Date().toISOString())\n   *   .withTransaction(transaction);\n   *\n   * // Execute all operations atomically\n   * await transaction.execute();\n   * ```\n   *\n   * @param transaction - The transaction builder to add this operation to\n   * @returns The builder instance for method chaining\n   */\n  withTransaction(transaction: TransactionBuilder) {\n    const command = this.toDynamoCommand();\n    transaction.updateWithCommand(command);\n  }\n\n  /**\n   * Gets a human-readable representation of the update command.\n   *\n   * @example\n   * ```typescript\n   * // Create complex update\n   * const builder = new UpdateBuilder(executor, 'dinosaurs', { id: 'RAPTOR-001' })\n   *   .set({\n   *     status: 'HUNTING',\n   *     'stats.health': 95,\n   *     'behavior.lastObserved': new Date().toISOString()\n   *   })\n   *   .add('huntingSuccesses', 1)\n   *   .condition(op => op.gt('health', 50));\n   *\n   * // Debug the update\n   * const debugInfo = builder.debug();\n   * console.log('Update operation:', debugInfo);\n   * ```\n   *\n   * @returns A readable representation of the update command with resolved expressions\n   */\n  debug(): DynamoItem {\n    const command = this.toDynamoCommand();\n    return debugCommand(command);\n  }\n\n  /**\n   * Executes the update operation against DynamoDB.\n   *\n   * @example\n   * ```typescript\n   * try {\n   *   // Update dinosaur status with conditions\n   *   const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })\n   *     .set({\n   *       status: 'FEEDING',\n   *       lastMeal: new Date().toISOString(),\n   *       'stats.hunger': 0\n   *     })\n   *     .add('feedingCount', 1)\n   *     .condition(op =>\n   *       op.and([\n   *         op.gt('stats.hunger', 80),\n   *         op.eq('status', 'HUNTING')\n   *       ])\n   *     )\n   *     .returnValues('ALL_NEW')\n   *     .execute();\n   *\n   *   if (result.item) {\n   *     console.log('Updated dinosaur:', result.item);\n   *   }\n   * } catch (error) {\n   *   // Handle condition check failure\n   *   console.error('Failed to update dinosaur:', error);\n   *   // Check if dinosaur wasn't hungry enough\n   *   if (error.name === 'ConditionalCheckFailedException') {\n   *     console.log('Dinosaur not ready for feeding');\n   *   }\n   * }\n   * ```\n   *\n   * @returns A promise that resolves to an DynamoItem containing the updated item (if returnValues is set)\n   * @throws {ConditionalCheckFailedException} If the condition check fails\n   * @throws {Error} If the update operation fails for other reasons\n   */\n  async execute(): Promise<{ item?: T }> {\n    const params = this.toDynamoCommand();\n    return this.executor(params);\n  }\n}\n"]}

package/dist/conditions.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/conditions.ts"],"names":[],"mappings":";;;AAiGO,IAAM,yBACX,GAAA,CAAC,IACD,KAAA,CAAC,MAAc,KAA+B,MAAA;AAAA,EAC5C,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA;AAQW,IAAA,EAAA,GAAK,0BAA0B,IAAI;AAQnC,IAAA,EAAA,GAAK,0BAA0B,IAAI;AAQnC,IAAA,EAAA,GAAK,0BAA0B,IAAI;AAQnC,IAAA,GAAA,GAAM,0BAA0B,KAAK;AAQrC,IAAA,EAAA,GAAK,0BAA0B,IAAI;AAQnC,IAAA,GAAA,GAAM,0BAA0B,KAAK;AAQ3C,IAAM,OAAU,GAAA,CAAC,IAAc,EAAA,KAAA,EAAgB,KAA+B,MAAA;AAAA,EACnF,IAAM,EAAA,SAAA;AAAA,EACN,IAAA;AAAA,EACA,KAAA,EAAO,CAAC,KAAA,EAAO,KAAK;AACtB,CAAA;AAQa,IAAA,OAAA,GAAU,CAAC,IAAA,EAAc,MAAkC,MAAA;AAAA,EACtE,IAAM,EAAA,IAAA;AAAA,EACN,IAAA;AAAA,EACA,KAAO,EAAA;AACT,CAAA;AAQa,IAAA,UAAA,GAAa,0BAA0B,YAAY;AAQnD,IAAA,QAAA,GAAW,0BAA0B,UAAU;AAQ/C,IAAA,eAAA,GAAkB,CAAC,IAA6B,MAAA;AAAA,EAC3D,IAAM,EAAA,iBAAA;AAAA,EACN;AACF,CAAA;AAQa,IAAA,kBAAA,GAAqB,CAAC,IAA6B,MAAA;AAAA,EAC9D,IAAM,EAAA,oBAAA;AAAA,EACN;AACF,CAAA;AAaa,IAAA,GAAA,GAAM,IAAI,UAAwC,MAAA;AAAA,EAC7D,IAAM,EAAA,KAAA;AAAA,EACN;AACF,CAAA;AAWa,IAAA,EAAA,GAAK,IAAI,UAAwC,MAAA;AAAA,EAC5D,IAAM,EAAA,IAAA;AAAA,EACN;AACF,CAAA;AAQa,IAAA,GAAA,GAAM,CAAC,SAAqC,MAAA;AAAA,EACvD,IAAM,EAAA,KAAA;AAAA,EACN;AACF,CAAA","file":"conditions.cjs","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"]}
+{"version":3,"sources":["../src/conditions.ts"],"names":[],"mappings":";;;AAiGO,IAAM,yBAAA,GACX,CAAC,IAAA,KACD,CAAC,MAAc,KAAA,MAA+B;AAAA,EAC5C,IAAA;AAAA,EACA,IAAA;AAAA,EACA;AACF,CAAA;AAQK,IAAM,EAAA,GAAK,0BAA0B,IAAI;AAQzC,IAAM,EAAA,GAAK,0BAA0B,IAAI;AAQzC,IAAM,EAAA,GAAK,0BAA0B,IAAI;AAQzC,IAAM,GAAA,GAAM,0BAA0B,KAAK;AAQ3C,IAAM,EAAA,GAAK,0BAA0B,IAAI;AAQzC,IAAM,GAAA,GAAM,0BAA0B,KAAK;AAQ3C,IAAM,OAAA,GAAU,CAAC,IAAA,EAAc,KAAA,EAAgB,KAAA,MAA+B;AAAA,EACnF,IAAA,EAAM,SAAA;AAAA,EACN,IAAA;AAAA,EACA,KAAA,EAAO,CAAC,KAAA,EAAO,KAAK;AACtB,CAAA;AAQO,IAAM,OAAA,GAAU,CAAC,IAAA,EAAc,MAAA,MAAkC;AAAA,EACtE,IAAA,EAAM,IAAA;AAAA,EACN,IAAA;AAAA,EACA,KAAA,EAAO;AACT,CAAA;AAQO,IAAM,UAAA,GAAa,0BAA0B,YAAY;AAQzD,IAAM,QAAA,GAAW,0BAA0B,UAAU;AAQrD,IAAM,eAAA,GAAkB,CAAC,IAAA,MAA6B;AAAA,EAC3D,IAAA,EAAM,iBAAA;AAAA,EACN;AACF,CAAA;AAQO,IAAM,kBAAA,GAAqB,CAAC,IAAA,MAA6B;AAAA,EAC9D,IAAA,EAAM,oBAAA;AAAA,EACN;AACF,CAAA;AAaO,IAAM,GAAA,GAAM,IAAI,UAAA,MAAwC;AAAA,EAC7D,IAAA,EAAM,KAAA;AAAA,EACN;AACF,CAAA;AAWO,IAAM,EAAA,GAAK,IAAI,UAAA,MAAwC;AAAA,EAC5D,IAAA,EAAM,IAAA;AAAA,EACN;AACF,CAAA;AAQO,IAAM,GAAA,GAAM,CAAC,SAAA,MAAqC;AAAA,EACvD,IAAA,EAAM,KAAA;AAAA,EACN;AACF,CAAA","file":"conditions.cjs","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"]}