@infra-blocks/aws-dynamodb 0.21.0 → 0.22.0

package/lib/cjs/commands/create-table.js

@@ -15,7 +15,6 @@ class CreateTable {
         this.lsis = lsis;
     }
     toAwsCommandInput() {
-        const { name } = this;
         const attributeDefinitions = new Map();
         const primaryKeySchema = keySchema({
             attributeDefinitions,
@@ -28,7 +27,7 @@ class CreateTable {
                 AttributeName: name,
                 AttributeType: type,
             })),
-            TableName: name,
+            TableName: this.name,
             KeySchema: primaryKeySchema,
             GlobalSecondaryIndexes: globalSecondaryIndexes.length > 0 ? globalSecondaryIndexes : undefined,
             LocalSecondaryIndexes: localSecondaryIndexes.length > 0 ? localSecondaryIndexes : undefined,
@@ -39,7 +38,7 @@ class CreateTable {
         return new client_dynamodb_1.CreateTableCommand(this.toAwsCommandInput());
     }
     gsiInput(attributeDefinitions) {
-        const { gsis = {} } = this;
+        const gsis = this.gsis ?? {};
         const globalSecondaryIndexes = [];
         for (const [indexName, field] of Object.entries(gsis)) {
             const ks = keySchema({
@@ -57,7 +56,7 @@ class CreateTable {
         return globalSecondaryIndexes;
     }
     lsiInput(attributeDefinitions) {
-        const { lsis = {} } = this;
+        const lsis = this.lsis ?? {};
         const localSecondaryIndexes = [];
         for (const [indexName, field] of Object.entries(lsis)) {
             const ks = keySchema({

package/lib/cjs/commands/create-table.js.map

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

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

@@ -17,7 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./condition.js"), exports);
 __exportStar(require("./key-condition.js"), exports);
 __exportStar(require("./operands/index.js"), exports);
-__exportStar(require("./update.js"), exports);
+__exportStar(require("./update/index.js"), exports);
 /*
 TODO: In the expression interfaces, a slight QoL improvement would be to assume that
 strings are attribute names by default, and other types are values by default. The user

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,sDAAoC;AACpC,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,oDAAkC;AAElC;;;;;GAKG"}

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

@@ -0,0 +1,33 @@
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { AddAction } from "./add.js";
+import type { UpdateExpressionClauses } from "./clauses.js";
+import type { DeleteAction } from "./delete.js";
+import type { RemoveAction } from "./remove.js";
+import type { SetAction } from "./set.js";
+export interface IUpdateAction {
+    /**
+     * Registers the action within the {@link UpdateExpressionClauses}.
+     *
+     * @param clauses - The clauses to register the action in.
+     */
+    register(clauses: UpdateExpressionClauses): void;
+    /**
+     * Stringifies the action within the clause.
+     *
+     * For example, if the action is a `SetAction`, it will be invoked as such:
+     * `SET ${action.stringify({names, values})}`. So the clause identifier is managed
+     * by the caller.
+     *
+     * @param params.names - The attribute names to substitute in the action.
+     * @param params.values - The attribute values to substitute in the action.
+     */
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+/**
+ * This type aggregates all the possible update actions that can be performed.
+ */
+export type UpdateAction = AddAction | DeleteAction | RemoveAction | SetAction;

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

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

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

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

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

@@ -0,0 +1,40 @@
+import type { AttributeValueNumber, AttributeValueSet } from "../../../types.js";
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { AttributeOperand } from "../operands/name.js";
+import type { ValueOperand } from "../operands/value.js";
+import type { IUpdateAction, UpdateAction } from "./action.js";
+import type { UpdateExpressionClauses } from "./clauses.js";
+type NumberOrSet = AttributeValueNumber | AttributeValueSet;
+export declare class AddAction implements IUpdateAction {
+    private readonly path;
+    private readonly value;
+    private constructor();
+    register(clauses: UpdateExpressionClauses): void;
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+    static from(params: {
+        path: AttributeOperand;
+        value: ValueOperand<NumberOrSet>;
+    }): AddAction;
+}
+/**
+ * Returns an action that will add the provided value to the attribute at the specified path.
+ *
+ * What adding means depends on the types of the operands:p
+ * - If both the attribute and the value are numbers, then an increment operation is performed.
+ * - If both the attribute and the value are sets, then a concatenation is performed.
+ *
+ * This action only supports numbers and sets as values.
+ *
+ * @param path - The attribute path to modify.
+ * @param value - The value to add to the attribute.
+ *
+ * @returns An {@link AddAction} that will add the value to the attribute at the specified path.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.ADD
+ */
+export declare function add(path: AttributeOperand, value: ValueOperand<NumberOrSet>): UpdateAction;
+export {};

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

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddAction = void 0;
+exports.add = add;
+// Note: the first operand *must* be an attribute name, and the second operand *must* be a value.
+class AddAction {
+    path;
+    value;
+    constructor(params) {
+        const { path, value } = params;
+        this.path = path;
+        this.value = value;
+    }
+    register(clauses) {
+        clauses.pushAddAction(this);
+    }
+    stringify(params) {
+        const { names, values } = params;
+        return `${this.path.substitute({ names })} ${this.value.substitute({ values })}`;
+    }
+    static from(params) {
+        return new AddAction(params);
+    }
+}
+exports.AddAction = AddAction;
+/**
+ * Returns an action that will add the provided value to the attribute at the specified path.
+ *
+ * What adding means depends on the types of the operands:p
+ * - If both the attribute and the value are numbers, then an increment operation is performed.
+ * - If both the attribute and the value are sets, then a concatenation is performed.
+ *
+ * This action only supports numbers and sets as values.
+ *
+ * @param path - The attribute path to modify.
+ * @param value - The value to add to the attribute.
+ *
+ * @returns An {@link AddAction} that will add the value to the attribute at the specified path.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.ADD
+ */
+function add(path, value) {
+    return AddAction.from({ path, value });
+}
+//# sourceMappingURL=add.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/add.ts"],"names":[],"mappings":";;;AAgEA,kBAKC;AAxDD,iGAAiG;AACjG,MAAa,SAAS;IACH,IAAI,CAAmB;IACvB,KAAK,CAA4B;IAElD,YAAoB,MAGnB;QACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,OAAgC;QACvC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC9B,CAAC;IAED,SAAS,CAAC,MAGT;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAGX;QACC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AA/BD,8BA+BC;AAED;;;;;;;;;;;;;;;GAeG;AAEH,SAAgB,GAAG,CACjB,IAAsB,EACtB,KAAgC;IAEhC,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { UpdateAction } from "./action.js";
+import type { AddAction } from "./add.js";
+import type { DeleteAction } from "./delete.js";
+import type { RemoveAction } from "./remove.js";
+import type { SetAction } from "./set.js";
+export declare class UpdateExpressionClauses {
+    private add?;
+    private delete?;
+    private remove?;
+    private set?;
+    private constructor();
+    getAddActions(): AddAction[] | undefined;
+    getDeleteActions(): DeleteAction[] | undefined;
+    getRemoveActions(): RemoveAction[] | undefined;
+    getSetActions(): SetAction[] | undefined;
+    pushAddAction(action: AddAction): void;
+    pushDeleteAction(action: DeleteAction): void;
+    pushRemoveAction(action: RemoveAction): void;
+    pushSetAction(action: SetAction): void;
+    static create(): UpdateExpressionClauses;
+    static from(params: ReadonlyArray<UpdateAction>): UpdateExpressionClauses;
+}

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

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateExpressionClauses = void 0;
+class UpdateExpressionClauses {
+    add;
+    delete;
+    remove;
+    set;
+    constructor() { }
+    getAddActions() {
+        return this.add;
+    }
+    getDeleteActions() {
+        return this.delete;
+    }
+    getRemoveActions() {
+        return this.remove;
+    }
+    getSetActions() {
+        return this.set;
+    }
+    pushAddAction(action) {
+        this.add ??= [];
+        this.add.push(action);
+    }
+    pushDeleteAction(action) {
+        this.delete ??= [];
+        this.delete.push(action);
+    }
+    pushRemoveAction(action) {
+        this.remove ??= [];
+        this.remove.push(action);
+    }
+    pushSetAction(action) {
+        this.set ??= [];
+        this.set.push(action);
+    }
+    static create() {
+        return new UpdateExpressionClauses();
+    }
+    static from(params) {
+        const clauses = UpdateExpressionClauses.create();
+        for (const action of params) {
+            action.register(clauses);
+        }
+        return clauses;
+    }
+}
+exports.UpdateExpressionClauses = UpdateExpressionClauses;
+//# sourceMappingURL=clauses.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"clauses.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/clauses.ts"],"names":[],"mappings":";;;AAMA,MAAa,uBAAuB;IAC1B,GAAG,CAAe;IAClB,MAAM,CAAkB;IACxB,MAAM,CAAkB;IACxB,GAAG,CAAe;IAE1B,gBAAuB,CAAC;IAExB,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,gBAAgB;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,aAAa;QACX,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,aAAa,CAAC,MAAiB;QAC7B,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,gBAAgB,CAAC,MAAoB;QACnC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,gBAAgB,CAAC,MAAoB;QACnC,IAAI,CAAC,MAAM,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC;IAED,aAAa,CAAC,MAAiB;QAC7B,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;QAChB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,uBAAuB,EAAE,CAAC;IACvC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAmC;QAC7C,MAAM,OAAO,GAAG,uBAAuB,CAAC,MAAM,EAAE,CAAC;QACjD,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;YAC5B,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAvDD,0DAuDC"}

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

@@ -0,0 +1,35 @@
+import type { AttributeValueSet } from "../../../types.js";
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { AttributeOperand } from "../operands/name.js";
+import type { ValueOperand } from "../operands/value.js";
+import type { IUpdateAction, UpdateAction } from "./action.js";
+import type { UpdateExpressionClauses } from "./clauses.js";
+export declare class DeleteAction implements IUpdateAction {
+    private readonly path;
+    private readonly value;
+    private constructor();
+    register(clauses: UpdateExpressionClauses): void;
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+    static from(params: {
+        path: AttributeOperand;
+        value: ValueOperand<AttributeValueSet>;
+    }): DeleteAction;
+}
+/**
+ * Returns an action that will delete the provided subset from the attribute at the specified path.
+ *
+ * This operation only supports sets as values. The resulting set will be the original set minus the
+ * provided subset.
+ *
+ * @param path - The attribute path to modify.
+ * @param value - The value to remove from the attribute.
+ *
+ * @returns A {@link DeleteAction} that will remove the subset from the attribute.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.DELETE
+ */
+export declare function deleteFrom(path: AttributeOperand, value: ValueOperand<AttributeValueSet>): UpdateAction;

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

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DeleteAction = void 0;
+exports.deleteFrom = deleteFrom;
+class DeleteAction {
+    path;
+    value;
+    constructor(params) {
+        const { path, value } = params;
+        this.path = path;
+        this.value = value;
+    }
+    register(clauses) {
+        clauses.pushDeleteAction(this);
+    }
+    stringify(params) {
+        const { names, values } = params;
+        return `${this.path.substitute({ names })} ${this.value.substitute({
+            values,
+        })}`;
+    }
+    static from(params) {
+        return new DeleteAction(params);
+    }
+}
+exports.DeleteAction = DeleteAction;
+/**
+ * Returns an action that will delete the provided subset from the attribute at the specified path.
+ *
+ * This operation only supports sets as values. The resulting set will be the original set minus the
+ * provided subset.
+ *
+ * @param path - The attribute path to modify.
+ * @param value - The value to remove from the attribute.
+ *
+ * @returns A {@link DeleteAction} that will remove the subset from the attribute.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.DELETE
+ */
+function deleteFrom(path, value) {
+    return DeleteAction.from({ path, value });
+}
+//# sourceMappingURL=delete.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/delete.ts"],"names":[],"mappings":";;;AAyDA,gCAKC;AAtDD,MAAa,YAAY;IACN,IAAI,CAAmB;IACvB,KAAK,CAAkC;IAExD,YAAoB,MAGnB;QACC,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QAC/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ,CAAC,OAAgC;QACvC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,MAGT;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YACjE,MAAM;SACP,CAAC,EAAE,CAAC;IACP,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAGX;QACC,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAjCD,oCAiCC;AAED;;;;;;;;;;;;GAYG;AAEH,SAAgB,UAAU,CACxB,IAAsB,EACtB,KAAsC;IAEtC,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -0,0 +1,22 @@
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { IExpression } from "../expression.js";
+import type { UpdateAction } from "./action.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();
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+    private pushAddActions;
+    private pushDeleteActions;
+    private pushRemoveActions;
+    private pushSetActions;
+    static from(params: UpdateExpressionParams): UpdateExpression;
+}

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

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateExpression = void 0;
+const clauses_js_1 = require("./clauses.js");
+/**
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html
+ */
+class UpdateExpression {
+    clauses;
+    constructor(clauses) {
+        this.clauses = clauses;
+    }
+    stringify(params) {
+        const { names, values } = params;
+        const parts = [];
+        this.pushAddActions({ parts, names, values });
+        this.pushDeleteActions({ parts, names, values });
+        this.pushRemoveActions({ parts, names });
+        this.pushSetActions({ parts, names, values });
+        return parts.join("\n");
+    }
+    pushAddActions(params) {
+        const { parts, names, values } = params;
+        const actions = this.clauses.getAddActions();
+        if (actions == null || actions.length === 0) {
+            return;
+        }
+        parts.push(`ADD ${actions
+            .map((action) => action.stringify({ names, values }))
+            .join(",")}`);
+    }
+    pushDeleteActions(params) {
+        const { parts, names, values } = params;
+        const actions = this.clauses.getDeleteActions();
+        if (actions == null || actions.length === 0) {
+            return;
+        }
+        parts.push(`DELETE ${actions
+            .map((action) => action.stringify({ names, values }))
+            .join(",")}`);
+    }
+    pushRemoveActions(params) {
+        const { parts, names } = params;
+        const actions = this.clauses.getRemoveActions();
+        if (actions == null || actions.length === 0) {
+            return;
+        }
+        parts.push(`REMOVE ${actions
+            .map((action) => action.stringify({ names }))
+            .join(",")}`);
+    }
+    pushSetActions(params) {
+        const { parts, names, values } = params;
+        const actions = this.clauses.getSetActions();
+        if (actions == null || actions.length === 0) {
+            return;
+        }
+        parts.push(`SET ${actions
+            .map((action) => action.stringify({ names, values }))
+            .join(",")}`);
+    }
+    static from(params) {
+        const clauses = clauses_js_1.UpdateExpressionClauses.from(params);
+        return new UpdateExpression(clauses);
+    }
+}
+exports.UpdateExpression = UpdateExpression;
+//# sourceMappingURL=expression.js.map

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

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

package/lib/cjs/commands/expressions/update/if-not-exists.d.ts

@@ -0,0 +1,17 @@
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeValues } from "../../attributes/values.js";
+import type { AttributeOperand } from "../operands/name.js";
+import type { IOperand, Operand } from "../operands/type.js";
+export declare class IfNotExistsOperand implements IOperand {
+    private readonly path;
+    private readonly defaultValue;
+    constructor(params: {
+        path: AttributeOperand;
+        defaultValue: Operand;
+    });
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare function ifNotExists(path: AttributeOperand, defaultValue: Operand): IfNotExistsOperand;

package/lib/cjs/commands/expressions/update/if-not-exists.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IfNotExistsOperand = void 0;
+exports.ifNotExists = ifNotExists;
+class IfNotExistsOperand {
+    path;
+    defaultValue;
+    constructor(params) {
+        const { path, defaultValue } = params;
+        this.path = path;
+        this.defaultValue = defaultValue;
+    }
+    substitute(params) {
+        const { names, values } = params;
+        return `if_not_exists(${this.path.substitute({ names })}, ${this.defaultValue.substitute({ names, values })})`;
+    }
+}
+exports.IfNotExistsOperand = IfNotExistsOperand;
+function ifNotExists(path, defaultValue) {
+    return new IfNotExistsOperand({ path, defaultValue });
+}
+//# sourceMappingURL=if-not-exists.js.map

package/lib/cjs/commands/expressions/update/if-not-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"if-not-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/if-not-exists.ts"],"names":[],"mappings":";;;AAwBA,kCAKC;AAxBD,MAAa,kBAAkB;IACZ,IAAI,CAAmB;IACvB,YAAY,CAAU;IAEvC,YAAY,MAAyD;QACnE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,CAAC;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,UAAU,CAAC,MAGV;QACC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QACjC,OAAO,iBAAiB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;IACjH,CAAC;CACF;AAjBD,gDAiBC;AAED,SAAgB,WAAW,CACzB,IAAsB,EACtB,YAAqB;IAErB,OAAO,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}

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

@@ -0,0 +1,7 @@
+export type { UpdateAction } from "./action.js";
+export { add } from "./add.js";
+export { deleteFrom } from "./delete.js";
+export * from "./expression.js";
+export { ifNotExists } from "./if-not-exists.js";
+export { remove } from "./remove.js";
+export { set } from "./set.js";

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

@@ -0,0 +1,29 @@
+"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 });
+exports.set = exports.remove = exports.ifNotExists = exports.deleteFrom = exports.add = void 0;
+var add_js_1 = require("./add.js");
+Object.defineProperty(exports, "add", { enumerable: true, get: function () { return add_js_1.add; } });
+var delete_js_1 = require("./delete.js");
+Object.defineProperty(exports, "deleteFrom", { enumerable: true, get: function () { return delete_js_1.deleteFrom; } });
+__exportStar(require("./expression.js"), exports);
+var if_not_exists_js_1 = require("./if-not-exists.js");
+Object.defineProperty(exports, "ifNotExists", { enumerable: true, get: function () { return if_not_exists_js_1.ifNotExists; } });
+var remove_js_1 = require("./remove.js");
+Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return remove_js_1.remove; } });
+var set_js_1 = require("./set.js");
+Object.defineProperty(exports, "set", { enumerable: true, get: function () { return set_js_1.set; } });
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AACA,mCAA+B;AAAtB,6FAAA,GAAG,OAAA;AACZ,yCAAyC;AAAhC,uGAAA,UAAU,OAAA;AACnB,kDAAgC;AAChC,uDAAiD;AAAxC,+GAAA,WAAW,OAAA;AACpB,yCAAqC;AAA5B,mGAAA,MAAM,OAAA;AACf,mCAA+B;AAAtB,6FAAA,GAAG,OAAA"}

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

@@ -0,0 +1,23 @@
+import type { AttributeNames } from "../../attributes/names.js";
+import type { AttributeOperand } from "../operands/name.js";
+import type { IUpdateAction, UpdateAction } from "./action.js";
+import type { UpdateExpressionClauses } from "./clauses.js";
+export declare class RemoveAction implements IUpdateAction {
+    private readonly path;
+    private constructor();
+    register(clauses: UpdateExpressionClauses): void;
+    stringify(params: {
+        names: AttributeNames;
+    }): string;
+    static from(path: AttributeOperand): RemoveAction;
+}
+/**
+ * Returns an action that will remove the specific attribute at the provided path.
+ *
+ * @param path - The path of the attribute to remove.
+ *
+ * @returns A {@link RemoveAction} corresponding to the path provided.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.DELETE
+ */
+export declare function remove(path: AttributeOperand): UpdateAction;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemoveAction = void 0;
+exports.remove = remove;
+class RemoveAction {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    register(clauses) {
+        clauses.pushRemoveAction(this);
+    }
+    stringify(params) {
+        const { names } = params;
+        return this.path.substitute({ names });
+    }
+    static from(path) {
+        return new RemoveAction(path);
+    }
+}
+exports.RemoveAction = RemoveAction;
+/**
+ * Returns an action that will remove the specific attribute at the provided path.
+ *
+ * @param path - The path of the attribute to remove.
+ *
+ * @returns A {@link RemoveAction} corresponding to the path provided.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.UpdateExpressions.html#Expressions.UpdateExpressions.DELETE
+ */
+function remove(path) {
+    return RemoveAction.from(path);
+}
+//# sourceMappingURL=remove.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/remove.ts"],"names":[],"mappings":";;;AAoCA,wBAEC;AAjCD,MAAa,YAAY;IACN,IAAI,CAAmB;IAExC,YAAoB,IAAsB;QACxC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,QAAQ,CAAC,OAAgC;QACvC,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,SAAS,CAAC,MAAiC;QACzC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,IAAsB;QAChC,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAnBD,oCAmBC;AAED;;;;;;;;GAQG;AAEH,SAAgB,MAAM,CAAC,IAAsB;IAC3C,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}