dyno-table 2.2.1 → 2.3.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.
Files changed (102) hide show
  1. package/README.md +187 -1865
  2. package/dist/builders.cjs +55 -0
  3. package/dist/builders.d.cts +4 -0
  4. package/dist/builders.d.ts +4 -0
  5. package/dist/builders.js +2 -0
  6. package/dist/chunk-2EWNZOUK.js +618 -0
  7. package/dist/chunk-2WIBY7PZ.js +46 -0
  8. package/dist/chunk-7UJJ7JXM.cjs +63 -0
  9. package/dist/chunk-DTFJJASK.js +3200 -0
  10. package/dist/chunk-EODPMYPE.js +558 -0
  11. package/dist/chunk-KA3VPIPS.cjs +560 -0
  12. package/dist/chunk-NTA6GDPP.cjs +622 -0
  13. package/dist/chunk-PB7BBCZO.cjs +32 -0
  14. package/dist/chunk-QVRMYGC4.js +29 -0
  15. package/dist/chunk-XYL43FDX.cjs +3217 -0
  16. package/dist/conditions.cjs +67 -62
  17. package/dist/conditions.js +1 -48
  18. package/dist/entity.cjs +14 -625
  19. package/dist/entity.d.cts +2 -10
  20. package/dist/entity.d.ts +2 -10
  21. package/dist/entity.js +2 -626
  22. package/dist/index-2cbm07Bi.d.ts +2797 -0
  23. package/dist/index-DlN8G9hd.d.cts +2797 -0
  24. package/dist/index.cjs +111 -4460
  25. package/dist/index.d.cts +2 -10
  26. package/dist/index.d.ts +2 -10
  27. package/dist/index.js +5 -4442
  28. package/dist/standard-schema.cjs +0 -2
  29. package/dist/standard-schema.js +0 -2
  30. package/dist/table.cjs +7 -3796
  31. package/dist/table.d.cts +163 -12
  32. package/dist/table.d.ts +163 -12
  33. package/dist/table.js +3 -3799
  34. package/dist/types.cjs +0 -2
  35. package/dist/types.js +0 -2
  36. package/dist/utils.cjs +10 -30
  37. package/dist/utils.js +1 -31
  38. package/package.json +6 -66
  39. package/dist/batch-builder-BiQDIZ7p.d.cts +0 -398
  40. package/dist/batch-builder-CNsLS6sR.d.ts +0 -398
  41. package/dist/builder-types-BTVhQSHI.d.cts +0 -169
  42. package/dist/builder-types-CzuLR4Th.d.ts +0 -169
  43. package/dist/builders/condition-check-builder.cjs +0 -422
  44. package/dist/builders/condition-check-builder.cjs.map +0 -1
  45. package/dist/builders/condition-check-builder.d.cts +0 -153
  46. package/dist/builders/condition-check-builder.d.ts +0 -153
  47. package/dist/builders/condition-check-builder.js +0 -420
  48. package/dist/builders/condition-check-builder.js.map +0 -1
  49. package/dist/builders/delete-builder.cjs +0 -484
  50. package/dist/builders/delete-builder.cjs.map +0 -1
  51. package/dist/builders/delete-builder.d.cts +0 -211
  52. package/dist/builders/delete-builder.d.ts +0 -211
  53. package/dist/builders/delete-builder.js +0 -482
  54. package/dist/builders/delete-builder.js.map +0 -1
  55. package/dist/builders/paginator.cjs +0 -193
  56. package/dist/builders/paginator.cjs.map +0 -1
  57. package/dist/builders/paginator.d.cts +0 -155
  58. package/dist/builders/paginator.d.ts +0 -155
  59. package/dist/builders/paginator.js +0 -191
  60. package/dist/builders/paginator.js.map +0 -1
  61. package/dist/builders/put-builder.cjs +0 -554
  62. package/dist/builders/put-builder.cjs.map +0 -1
  63. package/dist/builders/put-builder.d.cts +0 -319
  64. package/dist/builders/put-builder.d.ts +0 -319
  65. package/dist/builders/put-builder.js +0 -552
  66. package/dist/builders/put-builder.js.map +0 -1
  67. package/dist/builders/query-builder.cjs +0 -757
  68. package/dist/builders/query-builder.cjs.map +0 -1
  69. package/dist/builders/query-builder.d.cts +0 -6
  70. package/dist/builders/query-builder.d.ts +0 -6
  71. package/dist/builders/query-builder.js +0 -755
  72. package/dist/builders/query-builder.js.map +0 -1
  73. package/dist/builders/transaction-builder.cjs +0 -906
  74. package/dist/builders/transaction-builder.cjs.map +0 -1
  75. package/dist/builders/transaction-builder.d.cts +0 -464
  76. package/dist/builders/transaction-builder.d.ts +0 -464
  77. package/dist/builders/transaction-builder.js +0 -904
  78. package/dist/builders/transaction-builder.js.map +0 -1
  79. package/dist/builders/update-builder.cjs +0 -668
  80. package/dist/builders/update-builder.cjs.map +0 -1
  81. package/dist/builders/update-builder.d.cts +0 -374
  82. package/dist/builders/update-builder.d.ts +0 -374
  83. package/dist/builders/update-builder.js +0 -666
  84. package/dist/builders/update-builder.js.map +0 -1
  85. package/dist/conditions.cjs.map +0 -1
  86. package/dist/conditions.js.map +0 -1
  87. package/dist/entity.cjs.map +0 -1
  88. package/dist/entity.js.map +0 -1
  89. package/dist/index.cjs.map +0 -1
  90. package/dist/index.js.map +0 -1
  91. package/dist/query-builder-D3URwK9k.d.cts +0 -477
  92. package/dist/query-builder-cfEkU0_w.d.ts +0 -477
  93. package/dist/standard-schema.cjs.map +0 -1
  94. package/dist/standard-schema.js.map +0 -1
  95. package/dist/table-ClST8nkR.d.cts +0 -276
  96. package/dist/table-vE3cGoDy.d.ts +0 -276
  97. package/dist/table.cjs.map +0 -1
  98. package/dist/table.js.map +0 -1
  99. package/dist/types.cjs.map +0 -1
  100. package/dist/types.js.map +0 -1
  101. package/dist/utils.cjs.map +0 -1
  102. package/dist/utils.js.map +0 -1
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/expression.ts","../../src/utils/debug-expression.ts","../../src/utils/debug-transaction.ts","../../src/builders/transaction-builder.ts"],"names":[],"mappings":"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","file":"transaction-builder.cjs","sourcesContent":["import type { ComparisonOperator, Condition, ExpressionParams, LogicalOperator } from \"./conditions\";\n\nexport const generateAttributeName = (params: ExpressionParams, attr: string): string => {\n // Handle nested paths by splitting on dots\n if (attr.includes(\".\")) {\n const pathSegments = attr.split(\".\");\n const segmentNames: string[] = [];\n\n for (const segment of pathSegments) {\n // Check if this segment already exists in expressionAttributeNames\n let segmentName: string | undefined;\n for (const [existingName, existingAttr] of Object.entries(params.expressionAttributeNames)) {\n if (existingAttr === segment) {\n segmentName = existingName;\n break;\n }\n }\n\n // If not found, create a new attribute name for this segment\n if (!segmentName) {\n segmentName = `#${Object.keys(params.expressionAttributeNames).length}`;\n params.expressionAttributeNames[segmentName] = segment;\n }\n\n segmentNames.push(segmentName);\n }\n\n return segmentNames.join(\".\");\n }\n\n // Handle single-level attributes (original logic)\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 { TransactionItem } from \"../builders/builder-types\";\nimport { debugCommand } from \"./debug-expression\";\n\n/**\n * Utility function to create a human-readable representation of a transaction item\n * by replacing all expression placeholders with their actual values.\n *\n * @param item The transaction item to debug\n * @returns A readable representation of the transaction item\n */\nexport function debugTransactionItem(item: TransactionItem): Record<string, unknown> {\n const result: Record<string, unknown> = {\n type: item.type,\n tableName: item.params.tableName,\n };\n\n // Add key if present\n if (\"key\" in item.params) {\n result.key = item.params.key;\n }\n\n // Add item if present (for Put operations)\n if (item.type === \"Put\") {\n result.item = item.params.item;\n }\n\n // Add readable expressions based on operation type\n switch (item.type) {\n case \"Put\":\n case \"Delete\":\n case \"ConditionCheck\":\n result.readable = debugCommand(item.params).readable;\n break;\n case \"Update\":\n result.readable = debugCommand(item.params).readable;\n break;\n }\n\n return result;\n}\n\n/**\n * Utility function to create a human-readable representation of all transaction items\n * in a transaction by replacing all expression placeholders with their actual values.\n *\n * @param items Array of transaction items to debug\n * @returns An array of readable representations of the transaction items\n */\nexport function debugTransaction(items: TransactionItem[]): Record<string, unknown>[] {\n return items.map((item) => debugTransactionItem(item));\n}\n","import type { TransactWriteCommandInput } from \"@aws-sdk/lib-dynamodb\";\nimport type { Condition, PrimaryKeyWithoutExpression } from \"../conditions\";\nimport { prepareExpressionParams } from \"../expression\";\nimport type { DynamoItem } from \"../types\";\nimport { debugTransaction } from \"../utils/debug-transaction\";\nimport type {\n ConditionCheckCommandParams,\n DeleteCommandParams,\n PutCommandParams,\n TransactionItem,\n UpdateCommandParams,\n} from \"./builder-types\";\n\n/**\n * Configuration options for DynamoDB transactions.\n */\nexport interface TransactionOptions {\n /** Unique identifier for the transaction request (idempotency token) */\n clientRequestToken?: string;\n /** Level of consumed capacity details to return */\n returnConsumedCapacity?: \"INDEXES\" | \"TOTAL\" | \"NONE\";\n /** Whether to return item collection metrics */\n returnItemCollectionMetrics?: \"SIZE\" | \"NONE\";\n}\n\n/**\n * Configuration for table indexes used in duplicate detection.\n * Defines the key structure for checking uniqueness constraints.\n */\ninterface IndexConfig {\n /** The partition key attribute name */\n partitionKey: string;\n /** Optional sort key attribute name */\n sortKey?: string;\n}\n\n/**\n * Function type for executing DynamoDB transaction operations.\n * @param params - The complete transaction command input\n * @returns A promise that resolves when the transaction completes\n */\nexport type TransactionExecutor = (params: TransactWriteCommandInput) => Promise<void>;\n\n/**\n * Builder for creating and executing DynamoDB transactions.\n * Use this builder when you need to:\n * - Perform multiple operations atomically\n * - Ensure data consistency across operations\n * - Implement complex business logic that requires atomic updates\n * - Prevent duplicate items across tables\n *\n * The builder supports:\n * - Put operations (insert/replace items)\n * - Delete operations\n * - Update operations\n * - Condition checks\n * - Duplicate detection\n * - Transaction-wide options\n *\n * @example\n * ```typescript\n * // Create a transaction with multiple operations\n * const transaction = new TransactionBuilder(executor, {\n * partitionKey: 'id',\n * sortKey: 'type'\n * });\n *\n * // Add a new order\n * transaction.put('orders', {\n * orderId: '123',\n * status: 'PENDING'\n * });\n *\n * // Update inventory with condition\n * transaction.update(\n * 'inventory',\n * { productId: 'ABC' },\n * 'set quantity = quantity - :amount',\n * { ':amount': 1 },\n * op => op.gte('quantity', 1)\n * );\n *\n * // Execute the transaction atomically\n * await transaction.execute();\n * ```\n *\n * Note: DynamoDB transactions have some limitations:\n * - Maximum 25 operations per transaction\n * - All operations must be in the same AWS region\n * - Cannot include table scans or queries\n */\nexport class TransactionBuilder {\n private items: TransactionItem[] = [];\n private options: TransactionOptions = {};\n private indexConfig: IndexConfig;\n private readonly executor: TransactionExecutor;\n\n constructor(executor: TransactionExecutor, indexConfig: IndexConfig) {\n this.executor = executor;\n this.indexConfig = indexConfig;\n }\n\n /**\n * Checks if an item with the same primary key already exists in the transaction\n * @private\n */\n private checkForDuplicateItem(tableName: string, newItem: DynamoItem): void {\n const pkName = this.indexConfig.partitionKey;\n const skName = this.indexConfig.sortKey ?? \"\";\n\n // Extract the primary key values from the provided key\n const pkValue = newItem[pkName];\n const skValue = skName ? newItem[skName] : undefined;\n\n if (!pkValue) {\n throw new Error(`Primary key value for '${pkName}' is missing`);\n }\n\n const duplicateItem = this.items.find((item) => {\n // Get the key from the item based on its type\n let itemKey: Record<string, unknown> | undefined;\n let itemTableName: string | undefined;\n\n switch (item.type) {\n case \"Put\":\n itemTableName = item.params.tableName;\n // For Put operations, the key is part of the item\n itemKey = item.params.item;\n break;\n case \"Update\":\n case \"Delete\":\n case \"ConditionCheck\":\n itemTableName = item.params.tableName;\n itemKey = item.params.key;\n break;\n }\n\n // Check if the table name and keys match\n if (itemTableName === tableName && itemKey) {\n const itemPkValue = itemKey[pkName];\n const itemSkValue = skName ? itemKey[skName] : undefined;\n\n // Match if partition keys match and either both sort keys match or both are undefined\n if (itemPkValue === pkValue) {\n if (skValue === undefined && itemSkValue === undefined) {\n return true;\n }\n if (skValue !== undefined && itemSkValue !== undefined && skValue === itemSkValue) {\n return true;\n }\n }\n }\n\n return false;\n });\n\n if (duplicateItem) {\n throw new Error(\n `Duplicate item detected in transaction: Table=${tableName}, ${pkName}=${String(pkValue)}, ${skName}=${skValue !== undefined ? String(skValue) : \"undefined\"}. DynamoDB transactions do not allow multiple operations on the same item.`,\n );\n }\n }\n\n createKeyForPrimaryIndex(key: PrimaryKeyWithoutExpression) {\n // Turn the pk/sk into the key object\n const keyCondition = {\n [this.indexConfig.partitionKey]: key.pk,\n };\n\n if (this.indexConfig.sortKey) {\n if (key.sk === undefined) {\n throw new Error(\"Sort key is required for delete operation\");\n }\n keyCondition[this.indexConfig.sortKey] = key.sk;\n }\n\n return keyCondition;\n }\n\n /**\n * Adds a put operation to the transaction.\n *\n * The method automatically checks for duplicate items within the transaction\n * to prevent multiple operations on the same item.\n *\n * @example\n * ```typescript\n * // Simple put operation\n * transaction.put('orders', {\n * orderId: '123',\n * status: 'PENDING',\n * amount: 100\n * });\n *\n * // Conditional put operation\n * transaction.put(\n * 'inventory',\n * { productId: 'ABC', quantity: 50 },\n * op => op.attributeNotExists('productId')\n * );\n *\n * // Put with complex condition\n * transaction.put(\n * 'users',\n * { userId: '123', status: 'ACTIVE' },\n * op => op.and([\n * op.attributeNotExists('userId'),\n * op.beginsWith('status', 'ACTIVE')\n * ])\n * );\n * ```\n *\n * @param tableName - The name of the DynamoDB table\n * @param item - The item to put into the table\n * @param condition - Optional condition that must be satisfied\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n */\n put<T extends DynamoItem>(tableName: string, item: T, condition?: Condition): this {\n // Check for duplicate item\n this.checkForDuplicateItem(tableName, item);\n\n const transactionItem: TransactionItem = {\n type: \"Put\",\n params: {\n tableName,\n item,\n },\n };\n\n if (condition) {\n const { expression, names, values } = prepareExpressionParams(condition);\n transactionItem.params.conditionExpression = expression;\n transactionItem.params.expressionAttributeNames = names;\n transactionItem.params.expressionAttributeValues = values;\n }\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a pre-configured put operation to the transaction.\n *\n * This method is particularly useful when working with PutBuilder\n * to maintain consistency in put operations across your application.\n *\n * @example\n * ```typescript\n * // Create a put command with PutBuilder\n * const putCommand = new PutBuilder(executor, newItem, 'users')\n * .condition(op => op.attributeNotExists('userId'))\n * .toDynamoCommand();\n *\n * // Add the command to the transaction\n * transaction.putWithCommand(putCommand);\n * ```\n *\n * @param command - The complete put command configuration\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n * @see PutBuilder for creating put commands\n */\n putWithCommand(command: PutCommandParams): TransactionBuilder {\n // Check for duplicate item\n this.checkForDuplicateItem(command.tableName, command.item);\n\n const transactionItem: TransactionItem = {\n type: \"Put\",\n params: command,\n };\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a delete operation to the transaction.\n *\n * The method automatically checks for duplicate items within the transaction\n * to prevent multiple operations on the same item.\n *\n * @example\n * ```typescript\n * // Simple delete operation\n * transaction.delete('orders', {\n * pk: 'ORDER#123',\n * sk: 'METADATA'\n * });\n *\n * // Conditional delete operation\n * transaction.delete(\n * 'users',\n * { pk: 'USER#123' },\n * op => op.eq('status', 'INACTIVE')\n * );\n *\n * // Delete with complex condition\n * transaction.delete(\n * 'products',\n * { pk: 'PROD#ABC' },\n * op => op.and([\n * op.eq('status', 'DRAFT'),\n * op.lt('version', 5)\n * ])\n * );\n * ```\n *\n * @param tableName - The name of the DynamoDB table\n * @param key - The primary key of the item to delete\n * @param condition - Optional condition that must be satisfied\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n */\n delete(tableName: string, key: PrimaryKeyWithoutExpression, condition?: Condition): TransactionBuilder {\n const keyCondition = this.createKeyForPrimaryIndex(key);\n\n // Check for duplicate item\n this.checkForDuplicateItem(tableName, keyCondition);\n\n const transactionItem: TransactionItem = {\n type: \"Delete\",\n params: {\n tableName,\n key: keyCondition,\n },\n };\n\n if (condition) {\n const { expression, names, values } = prepareExpressionParams(condition);\n transactionItem.params.conditionExpression = expression;\n transactionItem.params.expressionAttributeNames = names;\n transactionItem.params.expressionAttributeValues = values;\n }\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a pre-configured delete operation to the transaction.\n *\n * This method is particularly useful when working with DeleteBuilder\n * to maintain consistency in delete operations across your application.\n *\n * @example\n * ```typescript\n * // Create a delete command with DeleteBuilder\n * const deleteCommand = new DeleteBuilder(executor, 'users', { pk: 'USER#123' })\n * .condition(op => op.and([\n * op.attributeExists('pk'),\n * op.eq('status', 'INACTIVE')\n * ]))\n * .toDynamoCommand();\n *\n * // Add the command to the transaction\n * transaction.deleteWithCommand(deleteCommand);\n * ```\n *\n * @param command - The complete delete command configuration\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n * @see DeleteBuilder for creating delete commands\n */\n deleteWithCommand(command: DeleteCommandParams): this {\n // The command.key from DeleteBuilder.toDynamoCommand() is in PrimaryKeyWithoutExpression format\n // but DeleteCommandParams expects it to be in the table's actual key format\n // We need to check if it's already converted or needs conversion\n let keyForDuplicateCheck: Record<string, unknown>;\n let keyForTransaction: Record<string, unknown>;\n\n // Check if the key is in PrimaryKeyWithoutExpression format (has pk/sk properties)\n if (typeof command.key === \"object\" && command.key !== null && \"pk\" in command.key) {\n // Convert from PrimaryKeyWithoutExpression to table key format\n keyForTransaction = this.createKeyForPrimaryIndex(command.key as PrimaryKeyWithoutExpression);\n keyForDuplicateCheck = keyForTransaction;\n } else {\n // Key is already in table format\n keyForTransaction = command.key;\n keyForDuplicateCheck = command.key;\n }\n\n // Check for duplicate item\n this.checkForDuplicateItem(command.tableName, keyForDuplicateCheck);\n\n const transactionItem: TransactionItem = {\n type: \"Delete\",\n params: {\n ...command,\n key: keyForTransaction,\n },\n };\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds an update operation to the transaction.\n *\n * The method supports all DynamoDB update expressions:\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 * transaction.update(\n * 'orders',\n * { pk: 'ORDER#123' },\n * 'SET #status = :status',\n * { '#status': 'status' },\n * { ':status': 'PROCESSING' }\n * );\n *\n * // Complex update with multiple operations\n * transaction.update(\n * 'products',\n * { pk: 'PROD#ABC' },\n * 'SET #qty = #qty - :amount, #status = :status REMOVE #oldAttr',\n * { '#qty': 'quantity', '#status': 'status', '#oldAttr': 'deprecated_field' },\n * { ':amount': 1, ':status': 'LOW_STOCK' }\n * );\n *\n * // Conditional update\n * transaction.update(\n * 'users',\n * { pk: 'USER#123' },\n * 'SET #lastLogin = :now',\n * { '#lastLogin': 'lastLoginDate' },\n * { ':now': new Date().toISOString() },\n * op => op.attributeExists('pk')\n * );\n * ```\n *\n * @param tableName - The name of the DynamoDB table\n * @param key - The primary key of the item to update\n * @param updateExpression - The update expression (SET, REMOVE, ADD, DELETE)\n * @param expressionAttributeNames - Map of attribute name placeholders to actual names\n * @param expressionAttributeValues - Map of value placeholders to actual values\n * @param condition - Optional condition that must be satisfied\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n */\n update<T extends DynamoItem>(\n tableName: string,\n key: PrimaryKeyWithoutExpression,\n updateExpression: string,\n expressionAttributeNames?: Record<string, string>,\n expressionAttributeValues?: Record<string, unknown>,\n condition?: Condition,\n ): this {\n const keyCondition = this.createKeyForPrimaryIndex(key);\n\n // Check for duplicate item\n this.checkForDuplicateItem(tableName, keyCondition);\n\n const transactionItem: TransactionItem = {\n type: \"Update\",\n params: {\n tableName,\n key: keyCondition,\n updateExpression,\n expressionAttributeNames,\n expressionAttributeValues,\n },\n };\n\n if (condition) {\n const { expression, names, values } = prepareExpressionParams(condition);\n transactionItem.params.conditionExpression = expression;\n\n // Merge the condition expression attribute names and values with the update ones\n transactionItem.params.expressionAttributeNames = {\n ...transactionItem.params.expressionAttributeNames,\n ...names,\n };\n\n transactionItem.params.expressionAttributeValues = {\n ...transactionItem.params.expressionAttributeValues,\n ...values,\n };\n }\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a pre-configured update operation to the transaction.\n *\n * This method is particularly useful when working with UpdateBuilder\n * to maintain consistency in update operations across your application.\n *\n * @example\n * ```typescript\n * // Create an update command with UpdateBuilder\n * const updateCommand = new UpdateBuilder(executor, 'inventory', { pk: 'PROD#ABC' })\n * .set('quantity', ':qty')\n * .set('lastUpdated', ':now')\n * .values({\n * ':qty': 100,\n * ':now': new Date().toISOString()\n * })\n * .condition(op => op.gt('quantity', 0))\n * .toDynamoCommand();\n *\n * // Add the command to the transaction\n * transaction.updateWithCommand(updateCommand);\n * ```\n *\n * @param command - The complete update command configuration\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n * @see UpdateBuilder for creating update commands\n */\n updateWithCommand(command: UpdateCommandParams): TransactionBuilder {\n // The command.key from UpdateBuilder.toDynamoCommand() is in PrimaryKeyWithoutExpression format\n // but UpdateCommandParams expects it to be in the table's actual key format\n // We need to check if it's already converted or needs conversion\n let keyForDuplicateCheck: Record<string, unknown>;\n let keyForTransaction: Record<string, unknown>;\n\n // Check if the key is in PrimaryKeyWithoutExpression format (has pk/sk properties)\n if (typeof command.key === \"object\" && command.key !== null && \"pk\" in command.key) {\n // Convert from PrimaryKeyWithoutExpression to table key format\n keyForTransaction = this.createKeyForPrimaryIndex(command.key as PrimaryKeyWithoutExpression);\n keyForDuplicateCheck = keyForTransaction;\n } else {\n // Key is already in table format\n keyForTransaction = command.key;\n keyForDuplicateCheck = command.key;\n }\n\n // Check for duplicate item\n this.checkForDuplicateItem(command.tableName, keyForDuplicateCheck);\n\n const transactionItem: TransactionItem = {\n type: \"Update\",\n params: {\n ...command,\n key: keyForTransaction,\n },\n };\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a condition check operation to the transaction.\n *\n * Condition checks are particularly useful for:\n * - Implementing optimistic locking\n * - Ensuring referential integrity\n * - Validating business rules atomically\n *\n * @example\n * ```typescript\n * // Check if order is in correct state\n * transaction.conditionCheck(\n * 'orders',\n * { pk: 'ORDER#123' },\n * op => op.eq('status', 'PENDING')\n * );\n *\n * // Complex condition check\n * transaction.conditionCheck(\n * 'inventory',\n * { pk: 'PROD#ABC' },\n * op => op.and([\n * op.gt('quantity', 0),\n * op.eq('status', 'ACTIVE'),\n * op.attributeExists('lastRestockDate')\n * ])\n * );\n *\n * // Check with multiple attributes\n * transaction.conditionCheck(\n * 'users',\n * { pk: 'USER#123' },\n * op => op.or([\n * op.eq('status', 'PREMIUM'),\n * op.gte('credits', 100)\n * ])\n * );\n * ```\n *\n * @param tableName - The name of the DynamoDB table\n * @param key - The primary key of the item to check\n * @param condition - The condition that must be satisfied\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n * @throws {Error} If condition expression generation fails\n */\n conditionCheck(tableName: string, key: PrimaryKeyWithoutExpression, condition: Condition): TransactionBuilder {\n const keyCondition = this.createKeyForPrimaryIndex(key);\n\n // Check for duplicate item\n this.checkForDuplicateItem(tableName, keyCondition);\n\n const { expression, names, values } = prepareExpressionParams(condition);\n\n if (!expression) {\n throw new Error(\"Failed to generate condition expression\");\n }\n\n const transactionItem: TransactionItem = {\n type: \"ConditionCheck\",\n params: {\n tableName,\n key: keyCondition,\n conditionExpression: expression,\n expressionAttributeNames: names,\n expressionAttributeValues: values,\n },\n };\n\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Adds a pre-configured condition check operation to the transaction.\n *\n * This method is particularly useful when working with ConditionCheckBuilder\n * to maintain consistency in condition checks across your application.\n *\n * @example\n * ```typescript\n * // Create a condition check with ConditionCheckBuilder\n * const checkCommand = new ConditionCheckBuilder('inventory', { pk: 'PROD#ABC' })\n * .condition(op => op.and([\n * op.between('quantity', 10, 100),\n * op.beginsWith('category', 'ELECTRONICS'),\n * op.attributeExists('lastAuditDate')\n * ]))\n * .toDynamoCommand();\n *\n * // Add the command to the transaction\n * transaction.conditionCheckWithCommand(checkCommand);\n * ```\n *\n * @param command - The complete condition check command configuration\n * @returns The transaction builder for method chaining\n * @throws {Error} If a duplicate item is detected in the transaction\n * @see ConditionCheckBuilder for creating condition check commands\n */\n conditionCheckWithCommand(command: ConditionCheckCommandParams): TransactionBuilder {\n // The command.key from ConditionCheckBuilder.toDynamoCommand() is in PrimaryKeyWithoutExpression format\n // but ConditionCheckCommandParams expects it to be in the table's actual key format\n // We need to check if it's already converted or needs conversion\n let keyForDuplicateCheck: Record<string, unknown>;\n let keyForTransaction: Record<string, unknown>;\n\n // Check if the key is in PrimaryKeyWithoutExpression format (has pk/sk properties)\n if (typeof command.key === \"object\" && command.key !== null && \"pk\" in command.key) {\n // Convert from PrimaryKeyWithoutExpression to table key format\n keyForTransaction = this.createKeyForPrimaryIndex(command.key as PrimaryKeyWithoutExpression);\n keyForDuplicateCheck = keyForTransaction;\n } else {\n // Key is already in table format\n keyForTransaction = command.key;\n keyForDuplicateCheck = command.key;\n }\n\n // Check for duplicate item\n this.checkForDuplicateItem(command.tableName, keyForDuplicateCheck);\n\n const transactionItem: TransactionItem = {\n type: \"ConditionCheck\",\n params: {\n ...command,\n key: keyForTransaction,\n },\n };\n this.items.push(transactionItem);\n return this;\n }\n\n /**\n * Sets options for the transaction execution.\n *\n * @example\n * ```typescript\n * // Enable idempotency and capacity tracking\n * transaction.withOptions({\n * clientRequestToken: 'unique-request-id-123',\n * returnConsumedCapacity: 'TOTAL'\n * });\n *\n * // Track item collection metrics\n * transaction.withOptions({\n * returnItemCollectionMetrics: 'SIZE'\n * });\n * ```\n *\n * Note: ClientRequestToken can be used to make transactions idempotent,\n * ensuring the same transaction is not executed multiple times.\n *\n * @param options - Configuration options for the transaction\n * @returns The transaction builder for method chaining\n */\n withOptions(options: TransactionOptions): TransactionBuilder {\n this.options = { ...this.options, ...options };\n return this;\n }\n\n /**\n * Gets a human-readable representation of the transaction items.\n *\n * The method resolves all expression placeholders with their actual values,\n * making it easier to understand the transaction's operations.\n *\n * @example\n * ```typescript\n * // Add multiple operations\n * transaction\n * .put('orders', { orderId: '123', status: 'PENDING' })\n * .update('inventory',\n * { productId: 'ABC' },\n * 'SET quantity = quantity - :amount',\n * undefined,\n * { ':amount': 1 }\n * );\n *\n * // Debug the transaction\n * const debugInfo = transaction.debug();\n * console.log('Transaction operations:', debugInfo);\n * ```\n *\n * @returns An array of readable representations of the transaction items\n */\n debug() {\n return debugTransaction(this.items);\n }\n\n /**\n * Executes all operations in the transaction atomically.\n *\n * The transaction will only succeed if all operations succeed.\n * If any operation fails, the entire transaction is rolled back.\n *\n * @example\n * ```typescript\n * try {\n * // Build and execute transaction\n * await transaction\n * .put('orders', newOrder)\n * .update('inventory',\n * { productId: 'ABC' },\n * 'SET quantity = quantity - :qty',\n * undefined,\n * { ':qty': 1 }\n * )\n * .conditionCheck('products',\n * { productId: 'ABC' },\n * op => op.eq('status', 'ACTIVE')\n * )\n * .execute();\n *\n * console.log('Transaction completed successfully');\n * } catch (error) {\n * // Handle transaction failure\n * console.error('Transaction failed:', error);\n * }\n * ```\n *\n * @throws {Error} If no transaction items are specified\n * @throws {Error} If any operation in the transaction fails\n * @returns A promise that resolves when the transaction completes\n */\n async execute(): Promise<void> {\n if (this.items.length === 0) {\n throw new Error(\"No transaction items specified\");\n }\n\n const transactItems = this.items.map((item) => {\n switch (item.type) {\n case \"Put\":\n return {\n Put: {\n TableName: item.params.tableName,\n Item: item.params.item,\n ConditionExpression: item.params.conditionExpression,\n ExpressionAttributeNames: item.params.expressionAttributeNames,\n ExpressionAttributeValues: item.params.expressionAttributeValues,\n },\n };\n case \"Delete\":\n return {\n Delete: {\n TableName: item.params.tableName,\n Key: item.params.key,\n ConditionExpression: item.params.conditionExpression,\n ExpressionAttributeNames: item.params.expressionAttributeNames,\n ExpressionAttributeValues: item.params.expressionAttributeValues,\n },\n };\n case \"Update\":\n return {\n Update: {\n TableName: item.params.tableName,\n Key: item.params.key,\n UpdateExpression: item.params.updateExpression,\n ConditionExpression: item.params.conditionExpression,\n ExpressionAttributeNames: item.params.expressionAttributeNames,\n ExpressionAttributeValues: item.params.expressionAttributeValues,\n },\n };\n case \"ConditionCheck\":\n return {\n ConditionCheck: {\n TableName: item.params.tableName,\n Key: item.params.key,\n ConditionExpression: item.params.conditionExpression,\n ExpressionAttributeNames: item.params.expressionAttributeNames,\n ExpressionAttributeValues: item.params.expressionAttributeValues,\n },\n };\n default: {\n // This should never happen as we've covered all cases in the union type\n const exhaustiveCheck: never = item;\n throw new Error(`Unsupported transaction item type: ${String(exhaustiveCheck)}`);\n }\n }\n });\n\n const params: TransactWriteCommandInput = {\n TransactItems: transactItems,\n ClientRequestToken: this.options.clientRequestToken,\n ReturnConsumedCapacity: this.options.returnConsumedCapacity,\n ReturnItemCollectionMetrics: this.options.returnItemCollectionMetrics,\n };\n\n try {\n await this.executor(params);\n } catch (error) {\n console.log(this.debug());\n console.error(\"Error executing transaction:\", error);\n throw error;\n }\n }\n}\n"]}
@@ -1,464 +0,0 @@
1
- import { TransactWriteCommandInput } from '@aws-sdk/lib-dynamodb';
2
- import { c as PrimaryKeyWithoutExpression, a as Condition } from '../conditions-CcZL0sR2.cjs';
3
- import { DynamoItem } from '../types.cjs';
4
- import { a as PutCommandParams, D as DeleteCommandParams, U as UpdateCommandParams, C as ConditionCheckCommandParams } from '../builder-types-BTVhQSHI.cjs';
5
-
6
- /**
7
- * Configuration options for DynamoDB transactions.
8
- */
9
- interface TransactionOptions {
10
- /** Unique identifier for the transaction request (idempotency token) */
11
- clientRequestToken?: string;
12
- /** Level of consumed capacity details to return */
13
- returnConsumedCapacity?: "INDEXES" | "TOTAL" | "NONE";
14
- /** Whether to return item collection metrics */
15
- returnItemCollectionMetrics?: "SIZE" | "NONE";
16
- }
17
- /**
18
- * Configuration for table indexes used in duplicate detection.
19
- * Defines the key structure for checking uniqueness constraints.
20
- */
21
- interface IndexConfig {
22
- /** The partition key attribute name */
23
- partitionKey: string;
24
- /** Optional sort key attribute name */
25
- sortKey?: string;
26
- }
27
- /**
28
- * Function type for executing DynamoDB transaction operations.
29
- * @param params - The complete transaction command input
30
- * @returns A promise that resolves when the transaction completes
31
- */
32
- type TransactionExecutor = (params: TransactWriteCommandInput) => Promise<void>;
33
- /**
34
- * Builder for creating and executing DynamoDB transactions.
35
- * Use this builder when you need to:
36
- * - Perform multiple operations atomically
37
- * - Ensure data consistency across operations
38
- * - Implement complex business logic that requires atomic updates
39
- * - Prevent duplicate items across tables
40
- *
41
- * The builder supports:
42
- * - Put operations (insert/replace items)
43
- * - Delete operations
44
- * - Update operations
45
- * - Condition checks
46
- * - Duplicate detection
47
- * - Transaction-wide options
48
- *
49
- * @example
50
- * ```typescript
51
- * // Create a transaction with multiple operations
52
- * const transaction = new TransactionBuilder(executor, {
53
- * partitionKey: 'id',
54
- * sortKey: 'type'
55
- * });
56
- *
57
- * // Add a new order
58
- * transaction.put('orders', {
59
- * orderId: '123',
60
- * status: 'PENDING'
61
- * });
62
- *
63
- * // Update inventory with condition
64
- * transaction.update(
65
- * 'inventory',
66
- * { productId: 'ABC' },
67
- * 'set quantity = quantity - :amount',
68
- * { ':amount': 1 },
69
- * op => op.gte('quantity', 1)
70
- * );
71
- *
72
- * // Execute the transaction atomically
73
- * await transaction.execute();
74
- * ```
75
- *
76
- * Note: DynamoDB transactions have some limitations:
77
- * - Maximum 25 operations per transaction
78
- * - All operations must be in the same AWS region
79
- * - Cannot include table scans or queries
80
- */
81
- declare class TransactionBuilder {
82
- private items;
83
- private options;
84
- private indexConfig;
85
- private readonly executor;
86
- constructor(executor: TransactionExecutor, indexConfig: IndexConfig);
87
- /**
88
- * Checks if an item with the same primary key already exists in the transaction
89
- * @private
90
- */
91
- private checkForDuplicateItem;
92
- createKeyForPrimaryIndex(key: PrimaryKeyWithoutExpression): {
93
- [x: string]: string;
94
- };
95
- /**
96
- * Adds a put operation to the transaction.
97
- *
98
- * The method automatically checks for duplicate items within the transaction
99
- * to prevent multiple operations on the same item.
100
- *
101
- * @example
102
- * ```typescript
103
- * // Simple put operation
104
- * transaction.put('orders', {
105
- * orderId: '123',
106
- * status: 'PENDING',
107
- * amount: 100
108
- * });
109
- *
110
- * // Conditional put operation
111
- * transaction.put(
112
- * 'inventory',
113
- * { productId: 'ABC', quantity: 50 },
114
- * op => op.attributeNotExists('productId')
115
- * );
116
- *
117
- * // Put with complex condition
118
- * transaction.put(
119
- * 'users',
120
- * { userId: '123', status: 'ACTIVE' },
121
- * op => op.and([
122
- * op.attributeNotExists('userId'),
123
- * op.beginsWith('status', 'ACTIVE')
124
- * ])
125
- * );
126
- * ```
127
- *
128
- * @param tableName - The name of the DynamoDB table
129
- * @param item - The item to put into the table
130
- * @param condition - Optional condition that must be satisfied
131
- * @returns The transaction builder for method chaining
132
- * @throws {Error} If a duplicate item is detected in the transaction
133
- */
134
- put<T extends DynamoItem>(tableName: string, item: T, condition?: Condition): this;
135
- /**
136
- * Adds a pre-configured put operation to the transaction.
137
- *
138
- * This method is particularly useful when working with PutBuilder
139
- * to maintain consistency in put operations across your application.
140
- *
141
- * @example
142
- * ```typescript
143
- * // Create a put command with PutBuilder
144
- * const putCommand = new PutBuilder(executor, newItem, 'users')
145
- * .condition(op => op.attributeNotExists('userId'))
146
- * .toDynamoCommand();
147
- *
148
- * // Add the command to the transaction
149
- * transaction.putWithCommand(putCommand);
150
- * ```
151
- *
152
- * @param command - The complete put command configuration
153
- * @returns The transaction builder for method chaining
154
- * @throws {Error} If a duplicate item is detected in the transaction
155
- * @see PutBuilder for creating put commands
156
- */
157
- putWithCommand(command: PutCommandParams): TransactionBuilder;
158
- /**
159
- * Adds a delete operation to the transaction.
160
- *
161
- * The method automatically checks for duplicate items within the transaction
162
- * to prevent multiple operations on the same item.
163
- *
164
- * @example
165
- * ```typescript
166
- * // Simple delete operation
167
- * transaction.delete('orders', {
168
- * pk: 'ORDER#123',
169
- * sk: 'METADATA'
170
- * });
171
- *
172
- * // Conditional delete operation
173
- * transaction.delete(
174
- * 'users',
175
- * { pk: 'USER#123' },
176
- * op => op.eq('status', 'INACTIVE')
177
- * );
178
- *
179
- * // Delete with complex condition
180
- * transaction.delete(
181
- * 'products',
182
- * { pk: 'PROD#ABC' },
183
- * op => op.and([
184
- * op.eq('status', 'DRAFT'),
185
- * op.lt('version', 5)
186
- * ])
187
- * );
188
- * ```
189
- *
190
- * @param tableName - The name of the DynamoDB table
191
- * @param key - The primary key of the item to delete
192
- * @param condition - Optional condition that must be satisfied
193
- * @returns The transaction builder for method chaining
194
- * @throws {Error} If a duplicate item is detected in the transaction
195
- */
196
- delete(tableName: string, key: PrimaryKeyWithoutExpression, condition?: Condition): TransactionBuilder;
197
- /**
198
- * Adds a pre-configured delete operation to the transaction.
199
- *
200
- * This method is particularly useful when working with DeleteBuilder
201
- * to maintain consistency in delete operations across your application.
202
- *
203
- * @example
204
- * ```typescript
205
- * // Create a delete command with DeleteBuilder
206
- * const deleteCommand = new DeleteBuilder(executor, 'users', { pk: 'USER#123' })
207
- * .condition(op => op.and([
208
- * op.attributeExists('pk'),
209
- * op.eq('status', 'INACTIVE')
210
- * ]))
211
- * .toDynamoCommand();
212
- *
213
- * // Add the command to the transaction
214
- * transaction.deleteWithCommand(deleteCommand);
215
- * ```
216
- *
217
- * @param command - The complete delete command configuration
218
- * @returns The transaction builder for method chaining
219
- * @throws {Error} If a duplicate item is detected in the transaction
220
- * @see DeleteBuilder for creating delete commands
221
- */
222
- deleteWithCommand(command: DeleteCommandParams): this;
223
- /**
224
- * Adds an update operation to the transaction.
225
- *
226
- * The method supports all DynamoDB update expressions:
227
- * - SET: Modify or add attributes
228
- * - REMOVE: Delete attributes
229
- * - ADD: Update numbers and sets
230
- * - DELETE: Remove elements from a set
231
- *
232
- * @example
233
- * ```typescript
234
- * // Simple update
235
- * transaction.update(
236
- * 'orders',
237
- * { pk: 'ORDER#123' },
238
- * 'SET #status = :status',
239
- * { '#status': 'status' },
240
- * { ':status': 'PROCESSING' }
241
- * );
242
- *
243
- * // Complex update with multiple operations
244
- * transaction.update(
245
- * 'products',
246
- * { pk: 'PROD#ABC' },
247
- * 'SET #qty = #qty - :amount, #status = :status REMOVE #oldAttr',
248
- * { '#qty': 'quantity', '#status': 'status', '#oldAttr': 'deprecated_field' },
249
- * { ':amount': 1, ':status': 'LOW_STOCK' }
250
- * );
251
- *
252
- * // Conditional update
253
- * transaction.update(
254
- * 'users',
255
- * { pk: 'USER#123' },
256
- * 'SET #lastLogin = :now',
257
- * { '#lastLogin': 'lastLoginDate' },
258
- * { ':now': new Date().toISOString() },
259
- * op => op.attributeExists('pk')
260
- * );
261
- * ```
262
- *
263
- * @param tableName - The name of the DynamoDB table
264
- * @param key - The primary key of the item to update
265
- * @param updateExpression - The update expression (SET, REMOVE, ADD, DELETE)
266
- * @param expressionAttributeNames - Map of attribute name placeholders to actual names
267
- * @param expressionAttributeValues - Map of value placeholders to actual values
268
- * @param condition - Optional condition that must be satisfied
269
- * @returns The transaction builder for method chaining
270
- * @throws {Error} If a duplicate item is detected in the transaction
271
- */
272
- update<T extends DynamoItem>(tableName: string, key: PrimaryKeyWithoutExpression, updateExpression: string, expressionAttributeNames?: Record<string, string>, expressionAttributeValues?: Record<string, unknown>, condition?: Condition): this;
273
- /**
274
- * Adds a pre-configured update operation to the transaction.
275
- *
276
- * This method is particularly useful when working with UpdateBuilder
277
- * to maintain consistency in update operations across your application.
278
- *
279
- * @example
280
- * ```typescript
281
- * // Create an update command with UpdateBuilder
282
- * const updateCommand = new UpdateBuilder(executor, 'inventory', { pk: 'PROD#ABC' })
283
- * .set('quantity', ':qty')
284
- * .set('lastUpdated', ':now')
285
- * .values({
286
- * ':qty': 100,
287
- * ':now': new Date().toISOString()
288
- * })
289
- * .condition(op => op.gt('quantity', 0))
290
- * .toDynamoCommand();
291
- *
292
- * // Add the command to the transaction
293
- * transaction.updateWithCommand(updateCommand);
294
- * ```
295
- *
296
- * @param command - The complete update command configuration
297
- * @returns The transaction builder for method chaining
298
- * @throws {Error} If a duplicate item is detected in the transaction
299
- * @see UpdateBuilder for creating update commands
300
- */
301
- updateWithCommand(command: UpdateCommandParams): TransactionBuilder;
302
- /**
303
- * Adds a condition check operation to the transaction.
304
- *
305
- * Condition checks are particularly useful for:
306
- * - Implementing optimistic locking
307
- * - Ensuring referential integrity
308
- * - Validating business rules atomically
309
- *
310
- * @example
311
- * ```typescript
312
- * // Check if order is in correct state
313
- * transaction.conditionCheck(
314
- * 'orders',
315
- * { pk: 'ORDER#123' },
316
- * op => op.eq('status', 'PENDING')
317
- * );
318
- *
319
- * // Complex condition check
320
- * transaction.conditionCheck(
321
- * 'inventory',
322
- * { pk: 'PROD#ABC' },
323
- * op => op.and([
324
- * op.gt('quantity', 0),
325
- * op.eq('status', 'ACTIVE'),
326
- * op.attributeExists('lastRestockDate')
327
- * ])
328
- * );
329
- *
330
- * // Check with multiple attributes
331
- * transaction.conditionCheck(
332
- * 'users',
333
- * { pk: 'USER#123' },
334
- * op => op.or([
335
- * op.eq('status', 'PREMIUM'),
336
- * op.gte('credits', 100)
337
- * ])
338
- * );
339
- * ```
340
- *
341
- * @param tableName - The name of the DynamoDB table
342
- * @param key - The primary key of the item to check
343
- * @param condition - The condition that must be satisfied
344
- * @returns The transaction builder for method chaining
345
- * @throws {Error} If a duplicate item is detected in the transaction
346
- * @throws {Error} If condition expression generation fails
347
- */
348
- conditionCheck(tableName: string, key: PrimaryKeyWithoutExpression, condition: Condition): TransactionBuilder;
349
- /**
350
- * Adds a pre-configured condition check operation to the transaction.
351
- *
352
- * This method is particularly useful when working with ConditionCheckBuilder
353
- * to maintain consistency in condition checks across your application.
354
- *
355
- * @example
356
- * ```typescript
357
- * // Create a condition check with ConditionCheckBuilder
358
- * const checkCommand = new ConditionCheckBuilder('inventory', { pk: 'PROD#ABC' })
359
- * .condition(op => op.and([
360
- * op.between('quantity', 10, 100),
361
- * op.beginsWith('category', 'ELECTRONICS'),
362
- * op.attributeExists('lastAuditDate')
363
- * ]))
364
- * .toDynamoCommand();
365
- *
366
- * // Add the command to the transaction
367
- * transaction.conditionCheckWithCommand(checkCommand);
368
- * ```
369
- *
370
- * @param command - The complete condition check command configuration
371
- * @returns The transaction builder for method chaining
372
- * @throws {Error} If a duplicate item is detected in the transaction
373
- * @see ConditionCheckBuilder for creating condition check commands
374
- */
375
- conditionCheckWithCommand(command: ConditionCheckCommandParams): TransactionBuilder;
376
- /**
377
- * Sets options for the transaction execution.
378
- *
379
- * @example
380
- * ```typescript
381
- * // Enable idempotency and capacity tracking
382
- * transaction.withOptions({
383
- * clientRequestToken: 'unique-request-id-123',
384
- * returnConsumedCapacity: 'TOTAL'
385
- * });
386
- *
387
- * // Track item collection metrics
388
- * transaction.withOptions({
389
- * returnItemCollectionMetrics: 'SIZE'
390
- * });
391
- * ```
392
- *
393
- * Note: ClientRequestToken can be used to make transactions idempotent,
394
- * ensuring the same transaction is not executed multiple times.
395
- *
396
- * @param options - Configuration options for the transaction
397
- * @returns The transaction builder for method chaining
398
- */
399
- withOptions(options: TransactionOptions): TransactionBuilder;
400
- /**
401
- * Gets a human-readable representation of the transaction items.
402
- *
403
- * The method resolves all expression placeholders with their actual values,
404
- * making it easier to understand the transaction's operations.
405
- *
406
- * @example
407
- * ```typescript
408
- * // Add multiple operations
409
- * transaction
410
- * .put('orders', { orderId: '123', status: 'PENDING' })
411
- * .update('inventory',
412
- * { productId: 'ABC' },
413
- * 'SET quantity = quantity - :amount',
414
- * undefined,
415
- * { ':amount': 1 }
416
- * );
417
- *
418
- * // Debug the transaction
419
- * const debugInfo = transaction.debug();
420
- * console.log('Transaction operations:', debugInfo);
421
- * ```
422
- *
423
- * @returns An array of readable representations of the transaction items
424
- */
425
- debug(): Record<string, unknown>[];
426
- /**
427
- * Executes all operations in the transaction atomically.
428
- *
429
- * The transaction will only succeed if all operations succeed.
430
- * If any operation fails, the entire transaction is rolled back.
431
- *
432
- * @example
433
- * ```typescript
434
- * try {
435
- * // Build and execute transaction
436
- * await transaction
437
- * .put('orders', newOrder)
438
- * .update('inventory',
439
- * { productId: 'ABC' },
440
- * 'SET quantity = quantity - :qty',
441
- * undefined,
442
- * { ':qty': 1 }
443
- * )
444
- * .conditionCheck('products',
445
- * { productId: 'ABC' },
446
- * op => op.eq('status', 'ACTIVE')
447
- * )
448
- * .execute();
449
- *
450
- * console.log('Transaction completed successfully');
451
- * } catch (error) {
452
- * // Handle transaction failure
453
- * console.error('Transaction failed:', error);
454
- * }
455
- * ```
456
- *
457
- * @throws {Error} If no transaction items are specified
458
- * @throws {Error} If any operation in the transaction fails
459
- * @returns A promise that resolves when the transaction completes
460
- */
461
- execute(): Promise<void>;
462
- }
463
-
464
- export { TransactionBuilder, type TransactionExecutor, type TransactionOptions };