@infra-blocks/aws-dynamodb 0.19.0 → 0.20.0

package/lib/cjs/commands/attributes/values.d.ts

@@ -3,15 +3,23 @@ export type ValueReference = `:${string}`;
 /**
  * Represents a set of attribute values used in an expression.
  *
- * This class provides an automated way to generate value reference variables
- * so that every value in an expression can be treated the same: systematically replaced
- * with an automatically generated variable.
+ * This class provides an automated way to generate value reference variables,
+ * or substitutions, so that every value in an expression can be treated
+ * the same: systematically replaced with an automatically generated variable.
  *
- * The class keeps track of the references generated for each value, such that when
- * the user requests a reference for a known value, that reference is returned.
+ * The class keeps track of the substitutions generated for each value, such that when
+ * the user requests a substitute for a known value, that previous one is returned.
+ *
+ * Values are compared using the SameValueZero algorithm(it uses a Map internally).
+ * This means that:
+ * ```ts
+ * assert(values.substitute(new Set([1,2,3])) !== values.substitute(new Set([1,2,3])));
+ * ```
  *
  * When the user requests a reference for an unknown value, then one is generated and
  * stored for future use.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Equality_comparisons_and_sameness#same-value-zero_equality
  */
 export declare class AttributeValues {
     private readonly values;

package/lib/cjs/commands/attributes/values.js

@@ -4,15 +4,23 @@ exports.AttributeValues = void 0;
 /**
  * Represents a set of attribute values used in an expression.
  *
- * This class provides an automated way to generate value reference variables
- * so that every value in an expression can be treated the same: systematically replaced
- * with an automatically generated variable.
+ * This class provides an automated way to generate value reference variables,
+ * or substitutions, so that every value in an expression can be treated
+ * the same: systematically replaced with an automatically generated variable.
  *
- * The class keeps track of the references generated for each value, such that when
- * the user requests a reference for a known value, that reference is returned.
+ * The class keeps track of the substitutions generated for each value, such that when
+ * the user requests a substitute for a known value, that previous one is returned.
+ *
+ * Values are compared using the SameValueZero algorithm(it uses a Map internally).
+ * This means that:
+ * ```ts
+ * assert(values.substitute(new Set([1,2,3])) !== values.substitute(new Set([1,2,3])));
+ * ```
  *
  * When the user requests a reference for an unknown value, then one is generated and
  * stored for future use.
+ *
+ * @see https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Equality_comparisons_and_sameness#same-value-zero_equality
  */
 class AttributeValues {
     values;

package/lib/cjs/commands/attributes/values.js.map

@@ -1 +1 @@
-{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../../src/commands/attributes/values.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;GAYG;AACH,MAAa,eAAe;IACT,MAAM,CAAsC;IAE7D;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAqB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAA2C,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,4BAA4B,CAAC,KAAqB;QACxD,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAoB,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;CACF;AAlDD,0CAkDC"}
+{"version":3,"file":"values.js","sourceRoot":"","sources":["../../../../src/commands/attributes/values.ts"],"names":[],"mappings":";;;AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,eAAe;IACT,MAAM,CAAsC;IAE7D;QACE,IAAI,CAAC,MAAM,GAAG,IAAI,GAAG,EAAkC,CAAC;IAC1D,CAAC;IAED;;;;;;;;;;;OAWG;IACH,UAAU,CAAC,KAAqB;QAC9B,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAC5E,CAAC;IAED;;;;;OAKG;IACH,gBAAgB;QACd,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,MAAM,MAAM,GAA2C,EAAE,CAAC;QAC1D,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,4BAA4B,CAAC,KAAqB;QACxD,MAAM,SAAS,GAAG,SAAS,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,CAAC,EAAoB,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;CACF;AAlDD,0CAkDC"}

package/lib/cjs/commands/expressions/condition.d.ts

@@ -2,7 +2,7 @@ import type { AttributeType } from "../../types.js";
 import type { AttributeNames } from "../attributes/names.js";
 import type { AttributeValues } from "../attributes/values.js";
 import type { IExpression } from "./expression.js";
-import { AttributeOperand, type IOperand, type Operand, type ValueOperand } from "./operands.js";
+import { AttributeOperand, type IOperand, type Operand, type ValueOperand } from "./operands/index.js";
 export type ConditionOperand = Operand | SizeOperand;
 export type Stringifier = (params: {
     names: AttributeNames;

package/lib/cjs/commands/expressions/condition.js

@@ -4,7 +4,7 @@ exports.SizeOperand = exports.AttributeConditionBuilder = exports.OperandConditi
 exports.not = not;
 exports.where = where;
 exports.size = size;
-const operands_js_1 = require("./operands.js");
+const index_js_1 = require("./operands/index.js");
 class Condition {
     stringifier;
     constructor(params) {
@@ -338,7 +338,7 @@ class AttributeConditionBuilder extends OperandConditionBuilder {
 }
 exports.AttributeConditionBuilder = AttributeConditionBuilder;
 function where(operand) {
-    if (operand instanceof operands_js_1.AttributeOperand) {
+    if (operand instanceof index_js_1.AttributeOperand) {
         return new AttributeConditionBuilder(operand);
     }
     return new OperandConditionBuilder(operand);

package/lib/cjs/commands/expressions/condition.js.map

@@ -1 +1 @@
-{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../../../src/commands/expressions/condition.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../../../src/commands/expressions/condition.ts"],"names":[],"mappings":"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"}

package/lib/cjs/commands/expressions/index.d.ts

@@ -1,4 +1,4 @@
 export * from "./condition.js";
 export * from "./key-condition.js";
-export * from "./operands.js";
+export * from "./operands/index.js";
 export * from "./update.js";

package/lib/cjs/commands/expressions/index.js

@@ -16,7 +16,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./condition.js"), exports);
 __exportStar(require("./key-condition.js"), exports);
-__exportStar(require("./operands.js"), exports);
+__exportStar(require("./operands/index.js"), exports);
 __exportStar(require("./update.js"), exports);
 /*
 TODO: In the expression interfaces, a slight QoL improvement would be to assume that

package/lib/cjs/commands/expressions/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/expressions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,qDAAmC;AACnC,gDAA8B;AAC9B,8CAA4B;AAE5B;;;;;GAKG"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/expressions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,qDAAmC;AACnC,sDAAoC;AACpC,8CAA4B;AAE5B;;;;;GAKG"}

package/lib/cjs/commands/expressions/operands/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./name.js";
+export * from "./type.js";
+export * from "./value.js";

package/lib/cjs/commands/expressions/operands/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./name.js"), exports);
+__exportStar(require("./type.js"), exports);
+__exportStar(require("./value.js"), exports);
+//# sourceMappingURL=index.js.map

package/lib/cjs/commands/expressions/operands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAC1B,4CAA0B;AAC1B,6CAA2B"}

package/lib/cjs/commands/expressions/operands/name.d.ts

@@ -0,0 +1,27 @@
+import type { AttributePath } from "../../../types.js";
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { IOperand } from "./type.js";
+/**
+ * Represents an attribute by name operand in an expression.
+ *
+ * When this operand is stringified, it first registers the
+ * attribute name in the {@link AttributeNames} registry and substitutes
+ * it with the returned value.
+ */
+export declare class AttributeOperand implements IOperand {
+    private readonly path;
+    constructor(path: AttributePath);
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+/**
+ * Factory function to create an `AttributeOperand` with fewer characters.
+ *
+ * @param path - The path of the attribute this operand represents.
+ *
+ * @returns A new {@link AttributeOperand} instance for the provided path.
+ */
+export declare function attribute(path: AttributePath): AttributeOperand;

package/lib/cjs/commands/expressions/operands/name.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeOperand = void 0;
+exports.attribute = attribute;
+/**
+ * Represents an attribute by name operand in an expression.
+ *
+ * When this operand is stringified, it first registers the
+ * attribute name in the {@link AttributeNames} registry and substitutes
+ * it with the returned value.
+ */
+class AttributeOperand {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    substitute(params) {
+        const { names } = params;
+        return names.substitute(this.path);
+    }
+}
+exports.AttributeOperand = AttributeOperand;
+/**
+ * Factory function to create an `AttributeOperand` with fewer characters.
+ *
+ * @param path - The path of the attribute this operand represents.
+ *
+ * @returns A new {@link AttributeOperand} instance for the provided path.
+ */
+function attribute(path) {
+    return new AttributeOperand(path);
+}
+//# sourceMappingURL=name.js.map

package/lib/cjs/commands/expressions/operands/name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/name.ts"],"names":[],"mappings":";;;AAmCA,8BAEC;AAhCD;;;;;;GAMG;AACH,MAAa,gBAAgB;IACV,IAAI,CAAgB;IAErC,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAGV;QACC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAdD,4CAcC;AAED;;;;;;GAMG;AACH,SAAgB,SAAS,CAAC,IAAmB;IAC3C,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}

package/lib/cjs/commands/expressions/operands/type.d.ts

@@ -0,0 +1,12 @@
+import type { AttributeValue } from "../../../types.js";
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { AttributeOperand } from "./name.js";
+import type { ValueOperand } from "./value.js";
+export type Operand<T extends AttributeValue = AttributeValue> = AttributeOperand | ValueOperand<T>;
+export interface IOperand {
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}

package/lib/cjs/commands/expressions/operands/type.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=type.js.map

package/lib/cjs/commands/expressions/operands/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/type.ts"],"names":[],"mappings":""}

package/lib/cjs/commands/expressions/operands/value.d.ts

@@ -0,0 +1,27 @@
+import type { AttributeValue } from "../../../types.js";
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { IOperand } from "./type.js";
+/**
+ * Represents a value operand in an expression.
+ *
+ * When this operand is stringified, it first registers the
+ * value in the {@link AttributeValues} registry and substitutes
+ * it with the returned value.
+ */
+export declare class ValueOperand<T extends AttributeValue = AttributeValue> implements IOperand {
+    private readonly value;
+    constructor(value: T);
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+/**
+ * Factory function to create a `ValueOperand` with fewer characters.
+ *
+ * @param value - The value this operand represents.
+ *
+ * @returns A new {@link ValueOperand} instance for the provided value.
+ */
+export declare function value<T extends AttributeValue = AttributeValue>(value: T): ValueOperand<T>;

package/lib/cjs/commands/expressions/operands/value.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValueOperand = void 0;
+exports.value = value;
+/**
+ * Represents a value operand in an expression.
+ *
+ * When this operand is stringified, it first registers the
+ * value in the {@link AttributeValues} registry and substitutes
+ * it with the returned value.
+ */
+class ValueOperand {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    substitute(params) {
+        const { values } = params;
+        return values.substitute(this.value);
+    }
+}
+exports.ValueOperand = ValueOperand;
+/**
+ * Factory function to create a `ValueOperand` with fewer characters.
+ *
+ * @param value - The value this operand represents.
+ *
+ * @returns A new {@link ValueOperand} instance for the provided value.
+ */
+function value(value) {
+    return new ValueOperand(value);
+}
+//# sourceMappingURL=value.js.map

package/lib/cjs/commands/expressions/operands/value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/value.ts"],"names":[],"mappings":";;;AAqCA,sBAIC;AApCD;;;;;;GAMG;AACH,MAAa,YAAY;IAGN,KAAK,CAAI;IAE1B,YAAY,KAAQ;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,MAGV;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvC,CAAC;CACF;AAhBD,oCAgBC;AAED;;;;;;GAMG;AACH,SAAgB,KAAK,CACnB,KAAQ;IAER,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/lib/cjs/commands/expressions/update.d.ts

@@ -1,8 +1,15 @@
+import type { AttributeValueNumber, AttributeValueSet } from "../../types.js";
 import type { AttributeNames } from "../attributes/names.js";
 import type { AttributeValues } from "../attributes/values.js";
 import type { IExpression } from "./expression.js";
-import type { AttributeOperand, IOperand, Operand } from "./operands.js";
+import type { AttributeOperand } from "./operands/name.js";
+import type { IOperand, Operand } from "./operands/type.js";
+import type { ValueOperand } from "./operands/value.js";
 export type UpdateExpressionParams = ReadonlyArray<UpdateAction>;
+/**
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html
+ */
 export declare class UpdateExpression implements IExpression {
     private readonly clauses;
     private constructor();
@@ -18,28 +25,28 @@ export interface IUpdateAction {
         values: AttributeValues;
     }): string;
 }
-export type UpdateAction = SetAction | RemoveAction;
-export type SetAction = Assignment | PlusAssignment | MinusAssignment;
+export type UpdateAction = SetAction | RemoveAction | AddAction;
+export type SetAction = SetTo | SetToPlus | SetToMinus;
 export type SetOperand = Operand | IfNotExistsOperand;
-declare class Assignment implements IUpdateAction {
+declare class SetTo implements IUpdateAction {
     private readonly path;
     private readonly operand;
     constructor(params: {
         path: AttributeOperand;
         operand: SetOperand;
     });
-    plus(operand: SetOperand): PlusAssignment;
-    minus(operand: SetOperand): MinusAssignment;
+    plus(operand: SetOperand): SetToPlus;
+    minus(operand: SetOperand): SetToMinus;
     stringify(params: {
         names: AttributeNames;
         values: AttributeValues;
     }): string;
 }
-export declare class PlusAssignment implements IUpdateAction {
+export declare class SetToPlus implements IUpdateAction {
     private readonly inner;
     private readonly operand;
     constructor(params: {
-        inner: Assignment;
+        inner: SetTo;
         operand: SetOperand;
     });
     stringify(params: {
@@ -47,11 +54,11 @@ export declare class PlusAssignment implements IUpdateAction {
         values: AttributeValues;
     }): string;
 }
-export declare class MinusAssignment implements IUpdateAction {
+export declare class SetToMinus implements IUpdateAction {
     private readonly inner;
     private readonly operand;
     constructor(params: {
-        inner: Assignment;
+        inner: SetTo;
         operand: SetOperand;
     });
     stringify(params: {
@@ -59,12 +66,12 @@ export declare class MinusAssignment implements IUpdateAction {
         values: AttributeValues;
     }): string;
 }
-declare class AssignmentBuilder {
+declare class SetToBuilder {
     private readonly path;
     constructor(path: AttributeOperand);
-    to(operand: SetOperand): Assignment;
+    to(operand: SetOperand): SetTo;
 }
-export declare function assign(path: AttributeOperand): AssignmentBuilder;
+export declare function set(path: AttributeOperand): SetToBuilder;
 export declare class RemoveAction implements IUpdateAction {
     private readonly path;
     private constructor();
@@ -82,6 +89,21 @@ export declare class RemoveAction implements IUpdateAction {
  * @returns A {@link RemoveAction} corresponding to the path provided.
  */
 export declare function remove(path: AttributeOperand): RemoveAction;
+type NumberOrSet = AttributeValueNumber | AttributeValueSet;
+export declare class AddAction implements IUpdateAction {
+    private readonly path;
+    private readonly value;
+    private constructor();
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+    static from(params: {
+        path: AttributeOperand;
+        value: ValueOperand<NumberOrSet>;
+    }): AddAction;
+}
+export declare function add(path: AttributeOperand, value: ValueOperand<NumberOrSet>): AddAction;
 export declare class IfNotExistsOperand implements IOperand {
     private readonly path;
     private readonly defaultValue;

package/lib/cjs/commands/expressions/update.js

@@ -1,9 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IfNotExistsOperand = exports.RemoveAction = exports.MinusAssignment = exports.PlusAssignment = exports.UpdateExpression = void 0;
-exports.assign = assign;
+exports.IfNotExistsOperand = exports.AddAction = exports.RemoveAction = exports.SetToMinus = exports.SetToPlus = exports.UpdateExpression = void 0;
+exports.set = set;
 exports.remove = remove;
+exports.add = add;
 exports.ifNotExists = ifNotExists;
+/**
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html
+ */
 class UpdateExpression {
     clauses;
     constructor(clauses) {
@@ -22,14 +27,19 @@ class UpdateExpression {
                 .map((action) => action.stringify({ names, values }))
                 .join(",")}`);
         }
+        if (this.clauses.add != null) {
+            parts.push(`ADD ${this.clauses.add
+                .map((action) => action.stringify({ names, values }))
+                .join(",")}`);
+        }
         return parts.join("\n");
     }
     static from(params) {
         const clauses = {};
         for (const action of params) {
-            if (action instanceof Assignment ||
-                action instanceof PlusAssignment ||
-                action instanceof MinusAssignment) {
+            if (action instanceof SetTo ||
+                action instanceof SetToPlus ||
+                action instanceof SetToMinus) {
                 clauses.set ??= [];
                 clauses.set.push(action);
             }
@@ -37,6 +47,10 @@ class UpdateExpression {
                 clauses.remove ??= [];
                 clauses.remove.push(action);
             }
+            else if (action instanceof AddAction) {
+                clauses.add ??= [];
+                clauses.add.push(action);
+            }
             else {
                 throw new Error("unknown action type in update expression");
             }
@@ -45,7 +59,7 @@ class UpdateExpression {
     }
 }
 exports.UpdateExpression = UpdateExpression;
-class Assignment {
+class SetTo {
     path;
     operand;
     constructor(params) {
@@ -54,10 +68,10 @@ class Assignment {
         this.operand = operand;
     }
     plus(operand) {
-        return new PlusAssignment({ inner: this, operand });
+        return new SetToPlus({ inner: this, operand });
     }
     minus(operand) {
-        return new MinusAssignment({ inner: this, operand });
+        return new SetToMinus({ inner: this, operand });
     }
     stringify(params) {
         const { names, values } = params;
@@ -67,7 +81,7 @@ class Assignment {
         })}`;
     }
 }
-class PlusAssignment {
+class SetToPlus {
     inner;
     operand;
     constructor(params) {
@@ -83,8 +97,8 @@ class PlusAssignment {
         })}`;
     }
 }
-exports.PlusAssignment = PlusAssignment;
-class MinusAssignment {
+exports.SetToPlus = SetToPlus;
+class SetToMinus {
     inner;
     operand;
     constructor(params) {
@@ -100,19 +114,21 @@ class MinusAssignment {
         })}`;
     }
 }
-exports.MinusAssignment = MinusAssignment;
-class AssignmentBuilder {
+exports.SetToMinus = SetToMinus;
+class SetToBuilder {
     path;
     constructor(path) {
         this.path = path;
     }
     to(operand) {
-        return new Assignment({ path: this.path, operand });
+        return new SetTo({ path: this.path, operand });
     }
 }
 // TODO: increment/decrement utilities built on top of the assignments.
-function assign(path) {
-    return new AssignmentBuilder(path);
+// TODO: review API for something more streamlined.... Imagine something like:
+// set(attribute(<name>), value(<value>)) or set(attribute(<name>), value(<first>), "+", value(<second>))
+function set(path) {
+    return new SetToBuilder(path);
 }
 class RemoveAction {
     path;
@@ -138,6 +154,28 @@ exports.RemoveAction = RemoveAction;
 function remove(path) {
     return RemoveAction.from(path);
 }
+// Note: the first operand *must* be an attribute name, and the second operand *must* be a value.
+// This action only makes sense for sets and numbers.
+class AddAction {
+    path;
+    value;
+    constructor(params) {
+        const { path, value } = params;
+        this.path = path;
+        this.value = value;
+    }
+    stringify(params) {
+        const { names, values } = params;
+        return `${this.path.substitute({ names, values })} ${this.value.substitute({ names, values })}`;
+    }
+    static from(params) {
+        return new AddAction(params);
+    }
+}
+exports.AddAction = AddAction;
+function add(path, value) {
+    return AddAction.from({ path, value });
+}
 class IfNotExistsOperand {
     path;
     defaultValue;

package/lib/cjs/commands/expressions/update.js.map

@@ -1 +1 @@
-{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/expressions/update.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"update.js","sourceRoot":"","sources":["../../../../src/commands/expressions/update.ts"],"names":[],"mappings":"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"}

package/lib/cjs/types.d.ts

@@ -1,7 +1,17 @@
 import type { ScalarAttributeType } from "@aws-sdk/client-dynamodb";
-import type { NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+import type { NativeAttributeBinary, NativeAttributeValue, NumberValue } from "@aws-sdk/lib-dynamodb";
 export type AttributeName = string;
 export type AttributeValue = NativeAttributeValue;
+/**
+ * A type regrouping all javascript native types that correspond to a valid DynamoDB
+ * number attribute.
+ */
+export type AttributeValueNumber = number | NumberValue | bigint;
+/**
+ * A type regrouping all javascript native types that corerspond to a valid DynamoDB
+ * set attribute.
+ */
+export type AttributeValueSet = Set<AttributeValueNumber | string | NativeAttributeBinary | undefined>;
 export type AttributePath = AttributeName;
 export type AttributeType = "S" | "N" | "B" | "BOOL" | "NULL" | "M" | "L" | "SS" | "NS" | "BS";
 export interface Attribute {