dyno-table 0.2.0-0 → 1.0.0-alpha.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +182 -577
- package/dist/{table.cjs → index.cjs} +175 -87
- package/dist/index.d.cts +2971 -0
- package/dist/index.d.ts +2971 -0
- package/dist/{table.js → index.js} +127 -86
- package/package.json +10 -77
- package/dist/builder-types-C_PDZhnP.d.ts +0 -118
- package/dist/builder-types-DtwbqMeF.d.cts +0 -118
- package/dist/builders/condition-check-builder.cjs +0 -394
- package/dist/builders/condition-check-builder.cjs.map +0 -1
- package/dist/builders/condition-check-builder.d.cts +0 -157
- package/dist/builders/condition-check-builder.d.ts +0 -157
- package/dist/builders/condition-check-builder.js +0 -392
- package/dist/builders/condition-check-builder.js.map +0 -1
- package/dist/builders/delete-builder.cjs +0 -405
- package/dist/builders/delete-builder.cjs.map +0 -1
- package/dist/builders/delete-builder.d.cts +0 -166
- package/dist/builders/delete-builder.d.ts +0 -166
- package/dist/builders/delete-builder.js +0 -403
- package/dist/builders/delete-builder.js.map +0 -1
- package/dist/builders/paginator.cjs +0 -199
- package/dist/builders/paginator.cjs.map +0 -1
- package/dist/builders/paginator.d.cts +0 -179
- package/dist/builders/paginator.d.ts +0 -179
- package/dist/builders/paginator.js +0 -197
- package/dist/builders/paginator.js.map +0 -1
- package/dist/builders/put-builder.cjs +0 -476
- package/dist/builders/put-builder.cjs.map +0 -1
- package/dist/builders/put-builder.d.cts +0 -274
- package/dist/builders/put-builder.d.ts +0 -274
- package/dist/builders/put-builder.js +0 -474
- package/dist/builders/put-builder.js.map +0 -1
- package/dist/builders/query-builder.cjs +0 -674
- package/dist/builders/query-builder.cjs.map +0 -1
- package/dist/builders/query-builder.d.cts +0 -6
- package/dist/builders/query-builder.d.ts +0 -6
- package/dist/builders/query-builder.js +0 -672
- package/dist/builders/query-builder.js.map +0 -1
- package/dist/builders/transaction-builder.cjs +0 -894
- package/dist/builders/transaction-builder.cjs.map +0 -1
- package/dist/builders/transaction-builder.d.cts +0 -511
- package/dist/builders/transaction-builder.d.ts +0 -511
- package/dist/builders/transaction-builder.js +0 -892
- package/dist/builders/transaction-builder.js.map +0 -1
- package/dist/builders/update-builder.cjs +0 -627
- package/dist/builders/update-builder.cjs.map +0 -1
- package/dist/builders/update-builder.d.cts +0 -365
- package/dist/builders/update-builder.d.ts +0 -365
- package/dist/builders/update-builder.js +0 -625
- package/dist/builders/update-builder.js.map +0 -1
- package/dist/conditions--ld9a78i.d.ts +0 -331
- package/dist/conditions-ChhQWd6z.d.cts +0 -331
- package/dist/conditions.cjs +0 -59
- package/dist/conditions.cjs.map +0 -1
- package/dist/conditions.d.cts +0 -3
- package/dist/conditions.d.ts +0 -3
- package/dist/conditions.js +0 -43
- package/dist/conditions.js.map +0 -1
- package/dist/entity.cjs +0 -228
- package/dist/entity.cjs.map +0 -1
- package/dist/entity.d.cts +0 -149
- package/dist/entity.d.ts +0 -149
- package/dist/entity.js +0 -224
- package/dist/entity.js.map +0 -1
- package/dist/query-builder-Csror9Iu.d.ts +0 -507
- package/dist/query-builder-D2FM9rsu.d.cts +0 -507
- package/dist/standard-schema.cjs +0 -4
- package/dist/standard-schema.cjs.map +0 -1
- package/dist/standard-schema.d.cts +0 -57
- package/dist/standard-schema.d.ts +0 -57
- package/dist/standard-schema.js +0 -3
- package/dist/standard-schema.js.map +0 -1
- package/dist/table-BEhBPy2G.d.cts +0 -364
- package/dist/table-BW3cmUqr.d.ts +0 -364
- package/dist/table.cjs.map +0 -1
- package/dist/table.d.cts +0 -12
- package/dist/table.d.ts +0 -12
- package/dist/table.js.map +0 -1
- package/dist/types.cjs +0 -4
- package/dist/types.cjs.map +0 -1
- package/dist/types.d.cts +0 -22
- package/dist/types.d.ts +0 -22
- package/dist/types.js +0 -3
- package/dist/types.js.map +0 -1
- package/dist/utils/partition-key-template.cjs +0 -19
- package/dist/utils/partition-key-template.cjs.map +0 -1
- package/dist/utils/partition-key-template.d.cts +0 -32
- package/dist/utils/partition-key-template.d.ts +0 -32
- package/dist/utils/partition-key-template.js +0 -17
- package/dist/utils/partition-key-template.js.map +0 -1
- package/dist/utils/sort-key-template.cjs +0 -19
- package/dist/utils/sort-key-template.cjs.map +0 -1
- package/dist/utils/sort-key-template.d.cts +0 -35
- package/dist/utils/sort-key-template.d.ts +0 -35
- package/dist/utils/sort-key-template.js +0 -17
- package/dist/utils/sort-key-template.js.map +0 -1
|
@@ -1 +0,0 @@
|
|
|
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.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 * - 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 | \"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 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 eq: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n ne: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n lt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n lte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n gt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n gte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n between: <K extends Path<T>>(attr: K, lower: PathType<T, K>, upper: PathType<T, K>) => Condition;\n beginsWith: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n contains: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n attributeExists: <K extends Path<T>>(attr: K) => Condition;\n attributeNotExists: <K extends Path<T>>(attr: K) => Condition;\n and: (...conditions: Condition[]) => Condition;\n or: (...conditions: Condition[]) => Condition;\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 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 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 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 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"]}
|
|
@@ -1,365 +0,0 @@
|
|
|
1
|
-
import { C as Condition, P as PrimaryKeyWithoutExpression, c as Path, d as PathType, b as ConditionOperator } from '../conditions-ChhQWd6z.cjs';
|
|
2
|
-
import { TransactionBuilder } from './transaction-builder.cjs';
|
|
3
|
-
import { U as UpdateCommandParams } from '../builder-types-DtwbqMeF.cjs';
|
|
4
|
-
import { DynamoItem } from '../types.cjs';
|
|
5
|
-
import '@aws-sdk/lib-dynamodb';
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* Configuration options for DynamoDB update operations.
|
|
9
|
-
*/
|
|
10
|
-
interface UpdateOptions {
|
|
11
|
-
/** Optional condition that must be satisfied for the update to succeed */
|
|
12
|
-
condition?: Condition;
|
|
13
|
-
/** Determines which item attributes to include in the response */
|
|
14
|
-
returnValues?: "ALL_NEW" | "UPDATED_NEW" | "ALL_OLD" | "UPDATED_OLD" | "NONE";
|
|
15
|
-
}
|
|
16
|
-
/**
|
|
17
|
-
* Function type for executing DynamoDB update operations.
|
|
18
|
-
* @typeParam T - The type of the item being updated
|
|
19
|
-
*/
|
|
20
|
-
type UpdateExecutor<T extends DynamoItem> = (params: UpdateCommandParams) => Promise<{
|
|
21
|
-
item?: T;
|
|
22
|
-
}>;
|
|
23
|
-
/**
|
|
24
|
-
* Represents a single update action within an update operation.
|
|
25
|
-
* Each action modifies the item in a specific way:
|
|
26
|
-
* - SET: Modify or add attributes
|
|
27
|
-
* - REMOVE: Delete attributes
|
|
28
|
-
* - ADD: Update numbers and sets
|
|
29
|
-
* - DELETE: Remove elements from a set
|
|
30
|
-
*/
|
|
31
|
-
type UpdateAction = {
|
|
32
|
-
/** The type of update action */
|
|
33
|
-
type: "SET" | "REMOVE" | "ADD" | "DELETE";
|
|
34
|
-
/** The attribute path to update */
|
|
35
|
-
path: string;
|
|
36
|
-
/** The value to use in the update (not used for REMOVE actions) */
|
|
37
|
-
value?: unknown;
|
|
38
|
-
};
|
|
39
|
-
/**
|
|
40
|
-
* Type utility to get the element type of a set.
|
|
41
|
-
* Extracts the element type from either a Set or Array type.
|
|
42
|
-
* @typeParam T - The set or array type
|
|
43
|
-
*/
|
|
44
|
-
type SetElementType<T> = T extends Set<infer U> ? U : T extends Array<infer U> ? U : never;
|
|
45
|
-
/**
|
|
46
|
-
* Type utility to get the element type from a path that points to a set.
|
|
47
|
-
* Combines PathType and SetElementType to get the element type at a specific path.
|
|
48
|
-
* @typeParam T - The type of the item
|
|
49
|
-
* @typeParam K - The path within the item
|
|
50
|
-
*/
|
|
51
|
-
type PathSetElementType<T, K extends Path<T>> = SetElementType<PathType<T, K>>;
|
|
52
|
-
/**
|
|
53
|
-
* Builder for creating DynamoDB update operations.
|
|
54
|
-
*
|
|
55
|
-
* The builder supports all DynamoDB update operations:
|
|
56
|
-
* - SET: Modify or add attributes
|
|
57
|
-
* - REMOVE: Delete attributes
|
|
58
|
-
* - ADD: Update numbers and sets
|
|
59
|
-
* - DELETE: Remove elements from a set
|
|
60
|
-
*
|
|
61
|
-
* @example
|
|
62
|
-
* ```typescript
|
|
63
|
-
* // Simple update
|
|
64
|
-
* const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })
|
|
65
|
-
* .set('status', 'HUNTING')
|
|
66
|
-
* .set('lastFed', new Date().toISOString())
|
|
67
|
-
* .execute();
|
|
68
|
-
*
|
|
69
|
-
* // Complex update with multiple operations
|
|
70
|
-
* const result = await new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })
|
|
71
|
-
* .set({
|
|
72
|
-
* status: 'OCCUPIED',
|
|
73
|
-
* occupants: 3,
|
|
74
|
-
* 'metadata.lastInspection': new Date().toISOString()
|
|
75
|
-
* })
|
|
76
|
-
* .add('securityBreaches', 1)
|
|
77
|
-
* .deleteElementsFromSet('suitableDinosaurs', ['VELOCIRAPTOR'])
|
|
78
|
-
* .condition(op => op.gt('securityLevel', 8))
|
|
79
|
-
* .returnValues('ALL_NEW')
|
|
80
|
-
* .execute();
|
|
81
|
-
* ```
|
|
82
|
-
*
|
|
83
|
-
* @typeParam T - The type of item being updated
|
|
84
|
-
*/
|
|
85
|
-
declare class UpdateBuilder<T extends DynamoItem> {
|
|
86
|
-
private updates;
|
|
87
|
-
private options;
|
|
88
|
-
private readonly executor;
|
|
89
|
-
private readonly tableName;
|
|
90
|
-
private readonly key;
|
|
91
|
-
constructor(executor: UpdateExecutor<T>, tableName: string, key: PrimaryKeyWithoutExpression);
|
|
92
|
-
/**
|
|
93
|
-
* Sets multiple attributes of an item using an object.
|
|
94
|
-
*
|
|
95
|
-
* @example
|
|
96
|
-
* ```typescript
|
|
97
|
-
* // Update multiple attributes
|
|
98
|
-
* builder.set({
|
|
99
|
-
* species: 'Tyrannosaurus Rex',
|
|
100
|
-
* height: 20,
|
|
101
|
-
* diet: 'CARNIVORE',
|
|
102
|
-
* 'stats.threatLevel': 10
|
|
103
|
-
* });
|
|
104
|
-
* ```
|
|
105
|
-
*/
|
|
106
|
-
set(values: Partial<T>): UpdateBuilder<T>;
|
|
107
|
-
/**
|
|
108
|
-
* Sets a single attribute to a specific value.
|
|
109
|
-
*
|
|
110
|
-
* @example
|
|
111
|
-
* ```typescript
|
|
112
|
-
* // Set simple attributes
|
|
113
|
-
* builder
|
|
114
|
-
* .set('status', 'SLEEPING')
|
|
115
|
-
* .set('lastFeeding', new Date().toISOString());
|
|
116
|
-
*
|
|
117
|
-
* // Set nested attributes
|
|
118
|
-
* builder
|
|
119
|
-
* .set('location.zone', 'RESTRICTED')
|
|
120
|
-
* .set('stats.health', 100);
|
|
121
|
-
* ```
|
|
122
|
-
*/
|
|
123
|
-
set<K extends Path<T>>(path: K, value: PathType<T, K>): UpdateBuilder<T>;
|
|
124
|
-
/**
|
|
125
|
-
* Removes an attribute from the item.
|
|
126
|
-
*
|
|
127
|
-
* @example
|
|
128
|
-
* ```typescript
|
|
129
|
-
* // Remove simple attributes
|
|
130
|
-
* builder
|
|
131
|
-
* .remove('temporaryTag')
|
|
132
|
-
* .remove('previousLocation');
|
|
133
|
-
*
|
|
134
|
-
* // Remove nested attributes
|
|
135
|
-
* builder
|
|
136
|
-
* .remove('metadata.testData')
|
|
137
|
-
* .remove('stats.experimentalMetrics');
|
|
138
|
-
* ```
|
|
139
|
-
*
|
|
140
|
-
* @param path - The path to the attribute to remove
|
|
141
|
-
* @returns The builder instance for method chaining
|
|
142
|
-
*/
|
|
143
|
-
remove<K extends Path<T>>(path: K): this;
|
|
144
|
-
/**
|
|
145
|
-
* Adds a value to a number attribute or adds elements to a set.
|
|
146
|
-
*
|
|
147
|
-
* @example
|
|
148
|
-
* ```typescript
|
|
149
|
-
* // Increment counters
|
|
150
|
-
* builder
|
|
151
|
-
* .add('escapeAttempts', 1)
|
|
152
|
-
* .add('feedingCount', 1);
|
|
153
|
-
*
|
|
154
|
-
* // Add to sets
|
|
155
|
-
* builder
|
|
156
|
-
* .add('knownBehaviors', new Set(['PACK_HUNTING', 'AMBUSH_TACTICS']))
|
|
157
|
-
* .add('visitedZones', new Set(['ZONE_A', 'ZONE_B']));
|
|
158
|
-
* ```
|
|
159
|
-
*
|
|
160
|
-
* @param path - The path to the attribute to update
|
|
161
|
-
* @param value - The value to add (number or set)
|
|
162
|
-
* @returns The builder instance for method chaining
|
|
163
|
-
*/
|
|
164
|
-
add<K extends Path<T>>(path: K, value: PathType<T, K>): this;
|
|
165
|
-
/**
|
|
166
|
-
* Removes elements from a set attribute.
|
|
167
|
-
*
|
|
168
|
-
* @example
|
|
169
|
-
* ```typescript
|
|
170
|
-
* // Remove from sets using arrays
|
|
171
|
-
* builder.deleteElementsFromSet(
|
|
172
|
-
* 'allowedHabitats',
|
|
173
|
-
* ['JUNGLE', 'COASTAL']
|
|
174
|
-
* );
|
|
175
|
-
*
|
|
176
|
-
* // Remove from sets using Set DynamoItems
|
|
177
|
-
* builder.deleteElementsFromSet(
|
|
178
|
-
* 'knownBehaviors',
|
|
179
|
-
* new Set(['NOCTURNAL', 'TERRITORIAL'])
|
|
180
|
-
* );
|
|
181
|
-
*
|
|
182
|
-
* // Remove from nested sets
|
|
183
|
-
* builder.deleteElementsFromSet(
|
|
184
|
-
* 'stats.compatibleSpecies',
|
|
185
|
-
* ['VELOCIRAPTOR', 'DILOPHOSAURUS']
|
|
186
|
-
* );
|
|
187
|
-
* ```
|
|
188
|
-
*
|
|
189
|
-
* @param path - The path to the set attribute
|
|
190
|
-
* @param value - Elements to remove (array or Set)
|
|
191
|
-
* @returns The builder instance for method chaining
|
|
192
|
-
*/
|
|
193
|
-
deleteElementsFromSet<K extends Path<T>>(path: K, value: PathSetElementType<T, K>[] | Set<PathSetElementType<T, K>>): this;
|
|
194
|
-
/**
|
|
195
|
-
* Adds a condition that must be satisfied for the update to succeed.
|
|
196
|
-
*
|
|
197
|
-
* @example
|
|
198
|
-
* ```typescript
|
|
199
|
-
* // Simple condition
|
|
200
|
-
* builder.condition(op =>
|
|
201
|
-
* op.eq('status', 'ACTIVE')
|
|
202
|
-
* );
|
|
203
|
-
*
|
|
204
|
-
* // Health check condition
|
|
205
|
-
* builder.condition(op =>
|
|
206
|
-
* op.and([
|
|
207
|
-
* op.gt('health', 50),
|
|
208
|
-
* op.eq('status', 'HUNTING')
|
|
209
|
-
* ])
|
|
210
|
-
* );
|
|
211
|
-
*
|
|
212
|
-
* // Complex security condition
|
|
213
|
-
* builder.condition(op =>
|
|
214
|
-
* op.and([
|
|
215
|
-
* op.attributeExists('securitySystem'),
|
|
216
|
-
* op.eq('containmentStatus', 'SECURE'),
|
|
217
|
-
* op.lt('aggressionLevel', 8)
|
|
218
|
-
* ])
|
|
219
|
-
* );
|
|
220
|
-
*
|
|
221
|
-
* // Version check (optimistic locking)
|
|
222
|
-
* builder.condition(op =>
|
|
223
|
-
* op.eq('version', currentVersion)
|
|
224
|
-
* );
|
|
225
|
-
* ```
|
|
226
|
-
*
|
|
227
|
-
* @param condition - Either a Condition DynamoItem or a callback function that builds the condition
|
|
228
|
-
* @returns The builder instance for method chaining
|
|
229
|
-
*/
|
|
230
|
-
condition(condition: Condition | ((op: ConditionOperator<T>) => Condition)): this;
|
|
231
|
-
/**
|
|
232
|
-
* Sets which item attributes to include in the response.
|
|
233
|
-
*
|
|
234
|
-
* Available options:
|
|
235
|
-
* - ALL_NEW: All attributes after the update
|
|
236
|
-
* - UPDATED_NEW: Only updated attributes, new values
|
|
237
|
-
* - ALL_OLD: All attributes before the update
|
|
238
|
-
* - UPDATED_OLD: Only updated attributes, old values
|
|
239
|
-
* - NONE: No attributes returned (default)
|
|
240
|
-
*
|
|
241
|
-
* @example
|
|
242
|
-
* ```typescript
|
|
243
|
-
* // Get complete updated dinosaur
|
|
244
|
-
* const result = await builder
|
|
245
|
-
* .set('status', 'SLEEPING')
|
|
246
|
-
* .returnValues('ALL_NEW')
|
|
247
|
-
* .execute();
|
|
248
|
-
*
|
|
249
|
-
* // Track specific attribute changes
|
|
250
|
-
* const result = await builder
|
|
251
|
-
* .set({
|
|
252
|
-
* 'stats.health': 100,
|
|
253
|
-
* 'stats.energy': 95
|
|
254
|
-
* })
|
|
255
|
-
* .returnValues('UPDATED_OLD')
|
|
256
|
-
* .execute();
|
|
257
|
-
*
|
|
258
|
-
* if (result.item) {
|
|
259
|
-
* console.log('Previous health:', result.item.stats?.health);
|
|
260
|
-
* }
|
|
261
|
-
* ```
|
|
262
|
-
*
|
|
263
|
-
* @param returnValues - Which attributes to return in the response
|
|
264
|
-
* @returns The builder instance for method chaining
|
|
265
|
-
*/
|
|
266
|
-
returnValues(returnValues: "ALL_NEW" | "UPDATED_NEW" | "ALL_OLD" | "UPDATED_OLD" | "NONE"): this;
|
|
267
|
-
/**
|
|
268
|
-
* Generate the DynamoDB command parameters
|
|
269
|
-
*/
|
|
270
|
-
toDynamoCommand(): UpdateCommandParams;
|
|
271
|
-
/**
|
|
272
|
-
* Adds this update operation to a transaction.
|
|
273
|
-
*
|
|
274
|
-
* @example
|
|
275
|
-
* ```typescript
|
|
276
|
-
* const transaction = new TransactionBuilder(executor);
|
|
277
|
-
*
|
|
278
|
-
* // Update dinosaur status and habitat occupancy atomically
|
|
279
|
-
* new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })
|
|
280
|
-
* .set('location', 'PADDOCK_A')
|
|
281
|
-
* .set('status', 'CONTAINED')
|
|
282
|
-
* .withTransaction(transaction);
|
|
283
|
-
*
|
|
284
|
-
* new UpdateBuilder(executor, 'habitats', { id: 'PADDOCK-A' })
|
|
285
|
-
* .add('occupants', 1)
|
|
286
|
-
* .set('lastOccupied', new Date().toISOString())
|
|
287
|
-
* .withTransaction(transaction);
|
|
288
|
-
*
|
|
289
|
-
* // Execute all operations atomically
|
|
290
|
-
* await transaction.execute();
|
|
291
|
-
* ```
|
|
292
|
-
*
|
|
293
|
-
* @param transaction - The transaction builder to add this operation to
|
|
294
|
-
* @returns The builder instance for method chaining
|
|
295
|
-
*/
|
|
296
|
-
withTransaction(transaction: TransactionBuilder): void;
|
|
297
|
-
/**
|
|
298
|
-
* Gets a human-readable representation of the update command.
|
|
299
|
-
*
|
|
300
|
-
* @example
|
|
301
|
-
* ```typescript
|
|
302
|
-
* // Create complex update
|
|
303
|
-
* const builder = new UpdateBuilder(executor, 'dinosaurs', { id: 'RAPTOR-001' })
|
|
304
|
-
* .set({
|
|
305
|
-
* status: 'HUNTING',
|
|
306
|
-
* 'stats.health': 95,
|
|
307
|
-
* 'behavior.lastObserved': new Date().toISOString()
|
|
308
|
-
* })
|
|
309
|
-
* .add('huntingSuccesses', 1)
|
|
310
|
-
* .condition(op => op.gt('health', 50));
|
|
311
|
-
*
|
|
312
|
-
* // Debug the update
|
|
313
|
-
* const debugInfo = builder.debug();
|
|
314
|
-
* console.log('Update operation:', debugInfo);
|
|
315
|
-
* ```
|
|
316
|
-
*
|
|
317
|
-
* @returns A readable representation of the update command with resolved expressions
|
|
318
|
-
*/
|
|
319
|
-
debug(): DynamoItem;
|
|
320
|
-
/**
|
|
321
|
-
* Executes the update operation against DynamoDB.
|
|
322
|
-
*
|
|
323
|
-
* @example
|
|
324
|
-
* ```typescript
|
|
325
|
-
* try {
|
|
326
|
-
* // Update dinosaur status with conditions
|
|
327
|
-
* const result = await new UpdateBuilder(executor, 'dinosaurs', { id: 'TREX-001' })
|
|
328
|
-
* .set({
|
|
329
|
-
* status: 'FEEDING',
|
|
330
|
-
* lastMeal: new Date().toISOString(),
|
|
331
|
-
* 'stats.hunger': 0
|
|
332
|
-
* })
|
|
333
|
-
* .add('feedingCount', 1)
|
|
334
|
-
* .condition(op =>
|
|
335
|
-
* op.and([
|
|
336
|
-
* op.gt('stats.hunger', 80),
|
|
337
|
-
* op.eq('status', 'HUNTING')
|
|
338
|
-
* ])
|
|
339
|
-
* )
|
|
340
|
-
* .returnValues('ALL_NEW')
|
|
341
|
-
* .execute();
|
|
342
|
-
*
|
|
343
|
-
* if (result.item) {
|
|
344
|
-
* console.log('Updated dinosaur:', result.item);
|
|
345
|
-
* }
|
|
346
|
-
* } catch (error) {
|
|
347
|
-
* // Handle condition check failure
|
|
348
|
-
* console.error('Failed to update dinosaur:', error);
|
|
349
|
-
* // Check if dinosaur wasn't hungry enough
|
|
350
|
-
* if (error.name === 'ConditionalCheckFailedException') {
|
|
351
|
-
* console.log('Dinosaur not ready for feeding');
|
|
352
|
-
* }
|
|
353
|
-
* }
|
|
354
|
-
* ```
|
|
355
|
-
*
|
|
356
|
-
* @returns A promise that resolves to an DynamoItem containing the updated item (if returnValues is set)
|
|
357
|
-
* @throws {ConditionalCheckFailedException} If the condition check fails
|
|
358
|
-
* @throws {Error} If the update operation fails for other reasons
|
|
359
|
-
*/
|
|
360
|
-
execute(): Promise<{
|
|
361
|
-
item?: T;
|
|
362
|
-
}>;
|
|
363
|
-
}
|
|
364
|
-
|
|
365
|
-
export { type UpdateAction, UpdateBuilder, type UpdateOptions };
|