@infra-blocks/aws-dynamodb 0.28.0-alpha.0 → 0.29.0-alpha.0

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

@@ -1,26 +1,26 @@
 import type { NativeBinary, NativeString, NativeType } from "../../../types.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import { ConditionExpression } from "./expression.js";
 import type { Size } from "./size.js";
 /**
  * Returns a condition that uses the `attribute_exists` function.
  *
- * @param attribute - The attribute path to check for existence.
+ * @param rawPath - The attribute path to check for existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path exists.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeExists(attribute: Path): ConditionExpression;
+export declare function attributeExists(rawPath: RawPath): ConditionExpression;
 /**
  * Returns a condition that uses the `attribute_not_exists` function.
  *
- * @param attribute - The attribute path to check for non-existence.
+ * @param rawPath - The attribute path to check for non-existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path does not exist.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeNotExists(attribute: Path): ConditionExpression;
+export declare function attributeNotExists(rawPath: RawPath): ConditionExpression;
 /**
  * Returns a condition that uses the `attribute_type` function.
  *
@@ -31,7 +31,7 @@ export declare function attributeNotExists(attribute: Path): ConditionExpression
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeType(attribute: Path, type: Value<NativeType>): ConditionExpression;
+export declare function attributeType(attribute: RawPath, type: Value<NativeType>): ConditionExpression;
 /**
  * This type aggregates the types of operands that can be used with the {@link beginsWith} function.
  *

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

@@ -5,31 +5,34 @@ exports.attributeNotExists = attributeNotExists;
 exports.attributeType = attributeType;
 exports.beginsWith = beginsWith;
 exports.contains = contains;
+const path_js_1 = require("../operands/path.js");
 const expression_js_1 = require("./expression.js");
 /**
  * Returns a condition that uses the `attribute_exists` function.
  *
- * @param attribute - The attribute path to check for existence.
+ * @param rawPath - The attribute path to check for existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path exists.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-function attributeExists(attribute) {
+function attributeExists(rawPath) {
+    const path = path_js_1.Path.normalize(rawPath);
     return expression_js_1.ConditionExpression.from({
-        stringify: ({ names }) => `attribute_exists(${attribute.substitute({ names })})`,
+        stringify: ({ names }) => `attribute_exists(${path.substitute({ names })})`,
     });
 }
 /**
  * Returns a condition that uses the `attribute_not_exists` function.
  *
- * @param attribute - The attribute path to check for non-existence.
+ * @param rawPath - The attribute path to check for non-existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path does not exist.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-function attributeNotExists(attribute) {
+function attributeNotExists(rawPath) {
+    const path = path_js_1.Path.normalize(rawPath);
     return expression_js_1.ConditionExpression.from({
-        stringify: ({ names }) => `attribute_not_exists(${attribute.substitute({ names })})`,
+        stringify: ({ names }) => `attribute_not_exists(${path.substitute({ names })})`,
     });
 }
 /**
@@ -43,8 +46,9 @@ function attributeNotExists(attribute) {
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
 function attributeType(attribute, type) {
+    const path = path_js_1.Path.normalize(attribute);
     return expression_js_1.ConditionExpression.from({
-        stringify: ({ names, values }) => `attribute_type(${attribute.substitute({ names })}, ${type.substitute({ values })})`,
+        stringify: ({ names, values }) => `attribute_type(${path.substitute({ names })}, ${type.substitute({ values })})`,
     });
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/functions.ts"],"names":[],"mappings":";;AAcA,0CAKC;AAUD,gDAKC;AAYD,sCAQC;AAmBD,gCAQC;AAqBD,4BAQC;AA3GD,mDAAsD;AAGtD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,SAAe;IAC7C,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,oBAAoB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,SAAe;IAChD,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,wBAAwB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,SAAe,EACf,IAAuB;IAEvB,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,kBAAkB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;KACvF,CAAC,CAAC;AACL,CAAC;AASD;;;;;;;;;GASG;AACH,SAAgB,UAAU,CACxB,KAAwB,EACxB,MAAyB;IAEzB,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,eAAe,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KACjG,CAAC,CAAC;AACL,CAAC;AAWD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CACtB,KAA2B,EAC3B,MAA6B;IAE7B,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,YAAY,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KAC9F,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/functions.ts"],"names":[],"mappings":";;AAcA,0CAKC;AAUD,gDAMC;AAYD,sCASC;AAmBD,gCAQC;AAsBD,4BAQC;AAhHD,iDAAyD;AAEzD,mDAAsD;AAGtD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,oBAAoB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KAC5E,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,wBAAwB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,SAAkB,EAClB,IAAuB;IAEvB,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,kBAAkB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;KAClF,CAAC,CAAC;AACL,CAAC;AASD;;;;;;;;;GASG;AACH,SAAgB,UAAU,CACxB,KAAwB,EACxB,MAAyB;IAEzB,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,eAAe,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KACjG,CAAC,CAAC;AACL,CAAC;AAYD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CACtB,KAA2B,EAC3B,MAA6B;IAE7B,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,YAAY,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KAC9F,CAAC,CAAC;AACL,CAAC"}

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

@@ -1,6 +1,27 @@
 import type { AttributePath } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { IOperand } from "./type.js";
+/**
+ * This type represents the types that can implicitly be used
+ * as path operands.
+ */
+export type ImplicitPath = AttributePath;
+/**
+ * This type aggregates the types that can be used as path operands.
+ *
+ * An {@link ImplicitPath} can be used in APIs that expect a {@link RawPath}
+ * just as well as an explicit {@link Path} instance.
+ *
+ * Using the {@link attributeExists} function as example, the following two
+ * invokations are equivalent:
+ * ```ts
+ * // Explicit path.
+ * attributeExists(path("foo.bar.baz"));
+ * // Implicit path.
+ * attributeExists("foo.bar.baz");
+ * ```
+ */
+export type RawPath = AttributePath | Path;
 /**
  * Represents an attribute path operand in an expression.
  *
@@ -10,10 +31,28 @@ import type { IOperand } from "./type.js";
  */
 export declare class Path implements IOperand {
     private readonly path;
-    constructor(path: AttributePath);
+    private constructor();
     substitute(params: {
         names: AttributeNames;
     }): string;
+    /**
+     * @private
+     */
+    static from(path: AttributePath): Path;
+    /**
+     * Turns {@link RawPath} path into a {@link Path} instance.
+     *
+     * If the provided path is already a {@link Path}, it will be returned as-is.
+     * Otherwise, a new {@link Path} instance will be created from the provided
+     * argument.
+     *
+     * @param loosePath - The path to return as is or convert to a {@link Path} instance.
+     *
+     * @returns The normalized {@link Path} instance.
+     *
+     * @private
+     */
+    static normalize(loosePath: RawPath): Path;
 }
 /**
  * Factory function to create a {@link Path}.

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

@@ -18,6 +18,31 @@ class Path {
         const { names } = params;
         return names.substitute(this.path);
     }
+    /**
+     * @private
+     */
+    static from(path) {
+        return new Path(path);
+    }
+    /**
+     * Turns {@link RawPath} path into a {@link Path} instance.
+     *
+     * If the provided path is already a {@link Path}, it will be returned as-is.
+     * Otherwise, a new {@link Path} instance will be created from the provided
+     * argument.
+     *
+     * @param loosePath - The path to return as is or convert to a {@link Path} instance.
+     *
+     * @returns The normalized {@link Path} instance.
+     *
+     * @private
+     */
+    static normalize(loosePath) {
+        if (loosePath instanceof Path) {
+            return loosePath;
+        }
+        return Path.from(loosePath);
+    }
 }
 exports.Path = Path;
 /**
@@ -28,6 +53,6 @@ exports.Path = Path;
  * @returns A new {@link Path} instance for the provided path.
  */
 function path(path) {
-    return new Path(path);
+    return Path.from(path);
 }
 //# sourceMappingURL=path.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/path.ts"],"names":[],"mappings":";;;AA+BA,oBAEC;AA7BD;;;;;;GAMG;AACH,MAAa,IAAI;IACE,IAAI,CAAgB;IAErC,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAAiC;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAXD,oBAWC;AAED;;;;;;GAMG;AACH,SAAgB,IAAI,CAAC,IAAmB;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/path.ts"],"names":[],"mappings":";;;AAiFA,oBAEC;AAxDD;;;;;;GAMG;AACH,MAAa,IAAI;IACE,IAAI,CAAgB;IAErC,YAAoB,IAAmB;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAAiC;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAmB;QAC7B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,SAAS,CAAC,SAAkB;QACjC,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;CACF;AAtCD,oBAsCC;AAED;;;;;;GAMG;AACH,SAAgB,IAAI,CAAC,IAAmB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

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

@@ -1,7 +1,7 @@
 import type { NativeNumber, NativeSet } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -29,12 +29,12 @@ export declare class AddAction implements IUpdateAction {
  *
  * This action only supports numbers and sets as values.
  *
- * @param path - The attribute path to modify.
+ * @param rawPath - 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: Path, value: Value<NumberOrSet>): UpdateAction;
+export declare function add(rawPath: RawPath, value: Value<NumberOrSet>): UpdateAction;
 export {};

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

@@ -2,7 +2,7 @@
 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.
+const path_js_1 = require("../operands/path.js");
 class AddAction {
     path;
     value;
@@ -32,14 +32,15 @@ exports.AddAction = AddAction;
  *
  * This action only supports numbers and sets as values.
  *
- * @param path - The attribute path to modify.
+ * @param rawPath - 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) {
+function add(rawPath, value) {
+    const path = path_js_1.Path.normalize(rawPath);
     return AddAction.from({ path, value });
 }
 //# sourceMappingURL=add.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/add.ts"],"names":[],"mappings":";;;AA0DA,kBAEC;AAlDD,iGAAiG;AACjG,MAAa,SAAS;IACH,IAAI,CAAO;IACX,KAAK,CAAqB;IAE3C,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,MAAiD;QAC3D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AA5BD,8BA4BC;AAED;;;;;;;;;;;;;;;GAeG;AAEH,SAAgB,GAAG,CAAC,IAAU,EAAE,KAAyB;IACvD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/add.ts"],"names":[],"mappings":";;;AAyDA,kBAGC;AAzDD,iDAAyD;AAOzD,MAAa,SAAS;IACH,IAAI,CAAO;IACX,KAAK,CAAqB;IAE3C,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,MAAiD;QAC3D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AA5BD,8BA4BC;AAED;;;;;;;;;;;;;;;GAeG;AAEH,SAAgB,GAAG,CAAC,OAAgB,EAAE,KAAyB;IAC7D,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

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

@@ -1,7 +1,7 @@
 import type { NativeSet } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -25,11 +25,11 @@ export declare class DeleteAction implements IUpdateAction {
  * 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 rawPath - 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: Path, value: Value<NativeSet>): UpdateAction;
+export declare function deleteFrom(rawPath: RawPath, value: Value<NativeSet>): UpdateAction;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DeleteAction = void 0;
 exports.deleteFrom = deleteFrom;
+const path_js_1 = require("../operands/path.js");
 class DeleteAction {
     path;
     value;
@@ -30,14 +31,15 @@ exports.DeleteAction = DeleteAction;
  * 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 rawPath - 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) {
+function deleteFrom(rawPath, value) {
+    const path = path_js_1.Path.normalize(rawPath);
     return DeleteAction.from({ path, value });
 }
 //# sourceMappingURL=delete.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/delete.ts"],"names":[],"mappings":";;;AAsDA,gCAEC;AAhDD,MAAa,YAAY;IACN,IAAI,CAAO;IACX,KAAK,CAAmB;IAEzC,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,MAA+C;QACzD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AA9BD,oCA8BC;AAED;;;;;;;;;;;;GAYG;AAEH,SAAgB,UAAU,CAAC,IAAU,EAAE,KAAuB;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/delete.ts"],"names":[],"mappings":";;;AAsDA,gCAMC;AAzDD,iDAAyD;AAKzD,MAAa,YAAY;IACN,IAAI,CAAO;IACX,KAAK,CAAmB;IAEzC,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,MAA+C;QACzD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AA9BD,oCA8BC;AAED;;;;;;;;;;;;GAYG;AAEH,SAAgB,UAAU,CACxB,OAAgB,EAChB,KAAuB;IAEvB,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { IOperand, Operand } from "../operands/type.js";
 export declare class IfNotExistsOperand implements IOperand {
     private readonly path;
@@ -14,4 +14,4 @@ export declare class IfNotExistsOperand implements IOperand {
         values: AttributeValues;
     }): string;
 }
-export declare function ifNotExists(path: Path, defaultValue: Operand): IfNotExistsOperand;
+export declare function ifNotExists(rawPath: RawPath, defaultValue: Operand): IfNotExistsOperand;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.IfNotExistsOperand = void 0;
 exports.ifNotExists = ifNotExists;
+const path_js_1 = require("../operands/path.js");
 class IfNotExistsOperand {
     path;
     defaultValue;
@@ -16,7 +17,8 @@ class IfNotExistsOperand {
     }
 }
 exports.IfNotExistsOperand = IfNotExistsOperand;
-function ifNotExists(path, defaultValue) {
+function ifNotExists(rawPath, defaultValue) {
+    const path = path_js_1.Path.normalize(rawPath);
     return new IfNotExistsOperand({ path, defaultValue });
 }
 //# sourceMappingURL=if-not-exists.js.map

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

@@ -1 +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,CAAO;IACX,YAAY,CAAU;IAEvC,YAAY,MAA6C;QACvD,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,IAAU,EACV,YAAqB;IAErB,OAAO,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"if-not-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/if-not-exists.ts"],"names":[],"mappings":";;;AAwBA,kCAMC;AA5BD,iDAAyD;AAGzD,MAAa,kBAAkB;IACZ,IAAI,CAAO;IACX,YAAY,CAAU;IAEvC,YAAY,MAA6C;QACvD,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,OAAgB,EAChB,YAAqB;IAErB,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}

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

@@ -1,5 +1,5 @@
 import type { AttributeNames } from "../../attributes/names.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
 export declare class RemoveAction implements IUpdateAction {
@@ -14,10 +14,10 @@ export declare class RemoveAction implements IUpdateAction {
 /**
  * Returns an action that will remove the specific attribute at the provided path.
  *
- * @param path - The path of the attribute to remove.
+ * @param rawPath - 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: Path): UpdateAction;
+export declare function remove(rawPath: RawPath): UpdateAction;

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RemoveAction = void 0;
 exports.remove = remove;
+const path_js_1 = require("../operands/path.js");
 class RemoveAction {
     path;
     constructor(path) {
@@ -22,13 +23,14 @@ 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.
+ * @param rawPath - 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) {
+function remove(rawPath) {
+    const path = path_js_1.Path.normalize(rawPath);
     return RemoveAction.from(path);
 }
 //# sourceMappingURL=remove.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/remove.ts"],"names":[],"mappings":";;;AAmCA,wBAEC;AAhCD,MAAa,YAAY;IACN,IAAI,CAAO;IAE5B,YAAoB,IAAU;QAC5B,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,IAAU;QACpB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAnBD,oCAmBC;AAED;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAC,IAAU;IAC/B,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/remove.ts"],"names":[],"mappings":";;;AAmCA,wBAGC;AArCD,iDAAyD;AAIzD,MAAa,YAAY;IACN,IAAI,CAAO;IAE5B,YAAoB,IAAU;QAC5B,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,IAAU;QACpB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAnBD,oCAmBC;AAED;;;;;;;;GAQG;AACH,SAAgB,MAAM,CAAC,OAAgB;IACrC,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Operand } from "../operands/type.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -26,6 +26,6 @@ export declare class SetAction implements IUpdateAction {
     }): string;
     static from(params: SetActionParams): SetAction;
 }
-export declare function set(path: Path, operand: SetOperand): UpdateAction;
-export declare function set(path: Path, operand: SetOperand, operator: SetOperator, secondOperand: SetOperand): UpdateAction;
+export declare function set(rawPath: RawPath, operand: SetOperand): UpdateAction;
+export declare function set(rawPath: RawPath, operand: SetOperand, operator: SetOperator, secondOperand: SetOperand): UpdateAction;
 export {};

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

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SetAction = void 0;
 exports.set = set;
+const path_js_1 = require("../operands/path.js");
 class SetAction {
     params;
     constructor(params) {
@@ -29,9 +30,9 @@ class SetAction {
     }
 }
 exports.SetAction = SetAction;
-function set(path, operand, operator, secondOperand) {
+function set(rawPath, operand, operator, secondOperand) {
     return SetAction.from({
-        path,
+        path: path_js_1.Path.normalize(rawPath),
         operand,
         operator,
         secondOperand,

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

@@ -1 +1 @@
-{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/set.ts"],"names":[],"mappings":";;;AAsEA,kBAYC;AA1DD,MAAa,SAAS;IACH,MAAM,CAAkB;IAEzC,YAAoB,MAAuB;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,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,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CACxF;YACE,KAAK;YACL,MAAM;SACP,CACF,EAAE,CAAC;QACJ,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CACxE;gBACE,KAAK;gBACL,MAAM;aACP,CACF,EAAE,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAuB;QACjC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AApCD,8BAoCC;AAUD,SAAgB,GAAG,CACjB,IAAU,EACV,OAAmB,EACnB,QAAsB,EACtB,aAA0B;IAE1B,OAAO,SAAS,CAAC,IAAI,CAAC;QACpB,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/set.ts"],"names":[],"mappings":";;;AAsEA,kBAYC;AAhFD,iDAAyD;AAsBzD,MAAa,SAAS;IACH,MAAM,CAAkB;IAEzC,YAAoB,MAAuB;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,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,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CACxF;YACE,KAAK;YACL,MAAM;SACP,CACF,EAAE,CAAC;QACJ,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CACxE;gBACE,KAAK;gBACL,MAAM;aACP,CACF,EAAE,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAuB;QACjC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AApCD,8BAoCC;AAUD,SAAgB,GAAG,CACjB,OAAgB,EAChB,OAAmB,EACnB,QAAsB,EACtB,aAA0B;IAE1B,OAAO,SAAS,CAAC,IAAI,CAAC;QACpB,IAAI,EAAE,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAC7B,OAAO;QACP,QAAQ;QACR,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}

package/lib/esm/commands/expressions/condition/functions.d.ts

@@ -1,26 +1,26 @@
 import type { NativeBinary, NativeString, NativeType } from "../../../types.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import { ConditionExpression } from "./expression.js";
 import type { Size } from "./size.js";
 /**
  * Returns a condition that uses the `attribute_exists` function.
  *
- * @param attribute - The attribute path to check for existence.
+ * @param rawPath - The attribute path to check for existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path exists.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeExists(attribute: Path): ConditionExpression;
+export declare function attributeExists(rawPath: RawPath): ConditionExpression;
 /**
  * Returns a condition that uses the `attribute_not_exists` function.
  *
- * @param attribute - The attribute path to check for non-existence.
+ * @param rawPath - The attribute path to check for non-existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path does not exist.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeNotExists(attribute: Path): ConditionExpression;
+export declare function attributeNotExists(rawPath: RawPath): ConditionExpression;
 /**
  * Returns a condition that uses the `attribute_type` function.
  *
@@ -31,7 +31,7 @@ export declare function attributeNotExists(attribute: Path): ConditionExpression
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export declare function attributeType(attribute: Path, type: Value<NativeType>): ConditionExpression;
+export declare function attributeType(attribute: RawPath, type: Value<NativeType>): ConditionExpression;
 /**
  * This type aggregates the types of operands that can be used with the {@link beginsWith} function.
  *

package/lib/esm/commands/expressions/condition/functions.js

@@ -1,28 +1,31 @@
+import { Path } from "../operands/path.js";
 import { ConditionExpression } from "./expression.js";
 /**
  * Returns a condition that uses the `attribute_exists` function.
  *
- * @param attribute - The attribute path to check for existence.
+ * @param rawPath - The attribute path to check for existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path exists.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export function attributeExists(attribute) {
+export function attributeExists(rawPath) {
+    const path = Path.normalize(rawPath);
     return ConditionExpression.from({
-        stringify: ({ names }) => `attribute_exists(${attribute.substitute({ names })})`,
+        stringify: ({ names }) => `attribute_exists(${path.substitute({ names })})`,
     });
 }
 /**
  * Returns a condition that uses the `attribute_not_exists` function.
  *
- * @param attribute - The attribute path to check for non-existence.
+ * @param rawPath - The attribute path to check for non-existence.
  * @returns A {@link ConditionExpression} that evaluates to true if the provided attribute path does not exist.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
-export function attributeNotExists(attribute) {
+export function attributeNotExists(rawPath) {
+    const path = Path.normalize(rawPath);
     return ConditionExpression.from({
-        stringify: ({ names }) => `attribute_not_exists(${attribute.substitute({ names })})`,
+        stringify: ({ names }) => `attribute_not_exists(${path.substitute({ names })})`,
     });
 }
 /**
@@ -36,8 +39,9 @@ export function attributeNotExists(attribute) {
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
  */
 export function attributeType(attribute, type) {
+    const path = Path.normalize(attribute);
     return ConditionExpression.from({
-        stringify: ({ names, values }) => `attribute_type(${attribute.substitute({ names })}, ${type.substitute({ values })})`,
+        stringify: ({ names, values }) => `attribute_type(${path.substitute({ names })}, ${type.substitute({ values })})`,
     });
 }
 /**

package/lib/esm/commands/expressions/condition/functions.js.map

@@ -1 +1 @@
-{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/functions.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,SAAe;IAC7C,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,oBAAoB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KACzD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,SAAe;IAChD,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,wBAAwB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KAC7D,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAe,EACf,IAAuB;IAEvB,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,kBAAkB,SAAS,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;KACvF,CAAC,CAAC;AACL,CAAC;AASD;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,MAAyB;IAEzB,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,eAAe,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KACjG,CAAC,CAAC;AACL,CAAC;AAWD;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACtB,KAA2B,EAC3B,MAA6B;IAE7B,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,YAAY,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KAC9F,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/functions.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAEzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAGtD;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,oBAAoB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KAC5E,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACvB,wBAAwB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;KACxD,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,SAAkB,EAClB,IAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,kBAAkB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;KAClF,CAAC,CAAC;AACL,CAAC;AASD;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,MAAyB;IAEzB,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,eAAe,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KACjG,CAAC,CAAC;AACL,CAAC;AAYD;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACtB,KAA2B,EAC3B,MAA6B;IAE7B,OAAO,mBAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAC/B,YAAY,KAAK,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG;KAC9F,CAAC,CAAC;AACL,CAAC"}

package/lib/esm/commands/expressions/operands/path.d.ts

@@ -1,6 +1,27 @@
 import type { AttributePath } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { IOperand } from "./type.js";
+/**
+ * This type represents the types that can implicitly be used
+ * as path operands.
+ */
+export type ImplicitPath = AttributePath;
+/**
+ * This type aggregates the types that can be used as path operands.
+ *
+ * An {@link ImplicitPath} can be used in APIs that expect a {@link RawPath}
+ * just as well as an explicit {@link Path} instance.
+ *
+ * Using the {@link attributeExists} function as example, the following two
+ * invokations are equivalent:
+ * ```ts
+ * // Explicit path.
+ * attributeExists(path("foo.bar.baz"));
+ * // Implicit path.
+ * attributeExists("foo.bar.baz");
+ * ```
+ */
+export type RawPath = AttributePath | Path;
 /**
  * Represents an attribute path operand in an expression.
  *
@@ -10,10 +31,28 @@ import type { IOperand } from "./type.js";
  */
 export declare class Path implements IOperand {
     private readonly path;
-    constructor(path: AttributePath);
+    private constructor();
     substitute(params: {
         names: AttributeNames;
     }): string;
+    /**
+     * @private
+     */
+    static from(path: AttributePath): Path;
+    /**
+     * Turns {@link RawPath} path into a {@link Path} instance.
+     *
+     * If the provided path is already a {@link Path}, it will be returned as-is.
+     * Otherwise, a new {@link Path} instance will be created from the provided
+     * argument.
+     *
+     * @param loosePath - The path to return as is or convert to a {@link Path} instance.
+     *
+     * @returns The normalized {@link Path} instance.
+     *
+     * @private
+     */
+    static normalize(loosePath: RawPath): Path;
 }
 /**
  * Factory function to create a {@link Path}.

package/lib/esm/commands/expressions/operands/path.js

@@ -14,6 +14,31 @@ export class Path {
         const { names } = params;
         return names.substitute(this.path);
     }
+    /**
+     * @private
+     */
+    static from(path) {
+        return new Path(path);
+    }
+    /**
+     * Turns {@link RawPath} path into a {@link Path} instance.
+     *
+     * If the provided path is already a {@link Path}, it will be returned as-is.
+     * Otherwise, a new {@link Path} instance will be created from the provided
+     * argument.
+     *
+     * @param loosePath - The path to return as is or convert to a {@link Path} instance.
+     *
+     * @returns The normalized {@link Path} instance.
+     *
+     * @private
+     */
+    static normalize(loosePath) {
+        if (loosePath instanceof Path) {
+            return loosePath;
+        }
+        return Path.from(loosePath);
+    }
 }
 /**
  * Factory function to create a {@link Path}.
@@ -23,6 +48,6 @@ export class Path {
  * @returns A new {@link Path} instance for the provided path.
  */
 export function path(path) {
-    return new Path(path);
+    return Path.from(path);
 }
 //# sourceMappingURL=path.js.map

package/lib/esm/commands/expressions/operands/path.js.map

@@ -1 +1 @@
-{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/path.ts"],"names":[],"mappings":"AAIA;;;;;;GAMG;AACH,MAAM,OAAO,IAAI;IACE,IAAI,CAAgB;IAErC,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAAiC;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,IAAmB;IACtC,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC"}
+{"version":3,"file":"path.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/path.ts"],"names":[],"mappings":"AA2BA;;;;;;GAMG;AACH,MAAM,OAAO,IAAI;IACE,IAAI,CAAgB;IAErC,YAAoB,IAAmB;QACrC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAAiC;QAC1C,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,IAAmB;QAC7B,OAAO,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,SAAS,CAAC,SAAkB;QACjC,IAAI,SAAS,YAAY,IAAI,EAAE,CAAC;YAC9B,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9B,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,UAAU,IAAI,CAAC,IAAmB;IACtC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC"}

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

@@ -1,7 +1,7 @@
 import type { NativeNumber, NativeSet } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -29,12 +29,12 @@ export declare class AddAction implements IUpdateAction {
  *
  * This action only supports numbers and sets as values.
  *
- * @param path - The attribute path to modify.
+ * @param rawPath - 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: Path, value: Value<NumberOrSet>): UpdateAction;
+export declare function add(rawPath: RawPath, value: Value<NumberOrSet>): UpdateAction;
 export {};

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

@@ -1,4 +1,4 @@
-// Note: the first operand *must* be an attribute name, and the second operand *must* be a value.
+import { Path } from "../operands/path.js";
 export class AddAction {
     path;
     value;
@@ -27,14 +27,15 @@ export class AddAction {
  *
  * This action only supports numbers and sets as values.
  *
- * @param path - The attribute path to modify.
+ * @param rawPath - 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 function add(path, value) {
+export function add(rawPath, value) {
+    const path = Path.normalize(rawPath);
     return AddAction.from({ path, value });
 }
 //# sourceMappingURL=add.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/add.ts"],"names":[],"mappings":"AAUA,iGAAiG;AACjG,MAAM,OAAO,SAAS;IACH,IAAI,CAAO;IACX,KAAK,CAAqB;IAE3C,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,MAAiD;QAC3D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,UAAU,GAAG,CAAC,IAAU,EAAE,KAAyB;IACvD,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}
+{"version":3,"file":"add.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/add.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAOzD,MAAM,OAAO,SAAS;IACH,IAAI,CAAO;IACX,KAAK,CAAqB;IAE3C,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,MAAiD;QAC3D,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AAED;;;;;;;;;;;;;;;GAeG;AAEH,MAAM,UAAU,GAAG,CAAC,OAAgB,EAAE,KAAyB;IAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AACzC,CAAC"}

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

@@ -1,7 +1,7 @@
 import type { NativeSet } from "../../../types.js";
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Value } from "../operands/value.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -25,11 +25,11 @@ export declare class DeleteAction implements IUpdateAction {
  * 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 rawPath - 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: Path, value: Value<NativeSet>): UpdateAction;
+export declare function deleteFrom(rawPath: RawPath, value: Value<NativeSet>): UpdateAction;

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

@@ -1,3 +1,4 @@
+import { Path } from "../operands/path.js";
 export class DeleteAction {
     path;
     value;
@@ -25,14 +26,15 @@ export class DeleteAction {
  * 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 rawPath - 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 function deleteFrom(path, value) {
+export function deleteFrom(rawPath, value) {
+    const path = Path.normalize(rawPath);
     return DeleteAction.from({ path, value });
 }
 //# sourceMappingURL=delete.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/delete.ts"],"names":[],"mappings":"AAQA,MAAM,OAAO,YAAY;IACN,IAAI,CAAO;IACX,KAAK,CAAmB;IAEzC,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,MAA+C;QACzD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,UAAU,CAAC,IAAU,EAAE,KAAuB;IAC5D,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/delete.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAKzD,MAAM,OAAO,YAAY;IACN,IAAI,CAAO;IACX,KAAK,CAAmB;IAEzC,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,MAA+C;QACzD,OAAO,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAClC,CAAC;CACF;AAED;;;;;;;;;;;;GAYG;AAEH,MAAM,UAAU,UAAU,CACxB,OAAgB,EAChB,KAAuB;IAEvB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { IOperand, Operand } from "../operands/type.js";
 export declare class IfNotExistsOperand implements IOperand {
     private readonly path;
@@ -14,4 +14,4 @@ export declare class IfNotExistsOperand implements IOperand {
         values: AttributeValues;
     }): string;
 }
-export declare function ifNotExists(path: Path, defaultValue: Operand): IfNotExistsOperand;
+export declare function ifNotExists(rawPath: RawPath, defaultValue: Operand): IfNotExistsOperand;

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

@@ -1,3 +1,4 @@
+import { Path } from "../operands/path.js";
 export class IfNotExistsOperand {
     path;
     defaultValue;
@@ -11,7 +12,8 @@ export class IfNotExistsOperand {
         return `if_not_exists(${this.path.substitute({ names })}, ${this.defaultValue.substitute({ names, values })})`;
     }
 }
-export function ifNotExists(path, defaultValue) {
+export function ifNotExists(rawPath, defaultValue) {
+    const path = Path.normalize(rawPath);
     return new IfNotExistsOperand({ path, defaultValue });
 }
 //# sourceMappingURL=if-not-exists.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"if-not-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/if-not-exists.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAO;IACX,YAAY,CAAU;IAEvC,YAAY,MAA6C;QACvD,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;AAED,MAAM,UAAU,WAAW,CACzB,IAAU,EACV,YAAqB;IAErB,OAAO,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"if-not-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/if-not-exists.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAGzD,MAAM,OAAO,kBAAkB;IACZ,IAAI,CAAO;IACX,YAAY,CAAU;IAEvC,YAAY,MAA6C;QACvD,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;AAED,MAAM,UAAU,WAAW,CACzB,OAAgB,EAChB,YAAqB;IAErB,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,kBAAkB,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;AACxD,CAAC"}

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

@@ -1,5 +1,5 @@
 import type { AttributeNames } from "../../attributes/names.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
 export declare class RemoveAction implements IUpdateAction {
@@ -14,10 +14,10 @@ export declare class RemoveAction implements IUpdateAction {
 /**
  * Returns an action that will remove the specific attribute at the provided path.
  *
- * @param path - The path of the attribute to remove.
+ * @param rawPath - 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: Path): UpdateAction;
+export declare function remove(rawPath: RawPath): UpdateAction;

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

@@ -1,3 +1,4 @@
+import { Path } from "../operands/path.js";
 export class RemoveAction {
     path;
     constructor(path) {
@@ -17,13 +18,14 @@ export class RemoveAction {
 /**
  * Returns an action that will remove the specific attribute at the provided path.
  *
- * @param path - The path of the attribute to remove.
+ * @param rawPath - 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 function remove(path) {
+export function remove(rawPath) {
+    const path = Path.normalize(rawPath);
     return RemoveAction.from(path);
 }
 //# sourceMappingURL=remove.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/remove.ts"],"names":[],"mappings":"AAKA,MAAM,OAAO,YAAY;IACN,IAAI,CAAO;IAE5B,YAAoB,IAAU;QAC5B,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,IAAU;QACpB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,IAAU;IAC/B,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/remove.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAIzD,MAAM,OAAO,YAAY;IACN,IAAI,CAAO;IAE5B,YAAoB,IAAU;QAC5B,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,IAAU;QACpB,OAAO,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;CACF;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,OAAgB;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACjC,CAAC"}

package/lib/esm/commands/expressions/update/set.d.ts

@@ -1,6 +1,6 @@
 import type { AttributeNames } from "../../attributes/names.js";
 import type { AttributeValues } from "../../attributes/values.js";
-import type { Path } from "../operands/path.js";
+import { Path, type RawPath } from "../operands/path.js";
 import type { Operand } from "../operands/type.js";
 import type { IUpdateAction, UpdateAction } from "./action.js";
 import type { UpdateExpressionClauses } from "./clauses.js";
@@ -26,6 +26,6 @@ export declare class SetAction implements IUpdateAction {
     }): string;
     static from(params: SetActionParams): SetAction;
 }
-export declare function set(path: Path, operand: SetOperand): UpdateAction;
-export declare function set(path: Path, operand: SetOperand, operator: SetOperator, secondOperand: SetOperand): UpdateAction;
+export declare function set(rawPath: RawPath, operand: SetOperand): UpdateAction;
+export declare function set(rawPath: RawPath, operand: SetOperand, operator: SetOperator, secondOperand: SetOperand): UpdateAction;
 export {};

package/lib/esm/commands/expressions/update/set.js

@@ -1,3 +1,4 @@
+import { Path } from "../operands/path.js";
 export class SetAction {
     params;
     constructor(params) {
@@ -24,9 +25,9 @@ export class SetAction {
         return new SetAction(params);
     }
 }
-export function set(path, operand, operator, secondOperand) {
+export function set(rawPath, operand, operator, secondOperand) {
     return SetAction.from({
-        path,
+        path: Path.normalize(rawPath),
         operand,
         operator,
         secondOperand,

package/lib/esm/commands/expressions/update/set.js.map

@@ -1 +1 @@
-{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/set.ts"],"names":[],"mappings":"AAwBA,MAAM,OAAO,SAAS;IACH,MAAM,CAAkB;IAEzC,YAAoB,MAAuB;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,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,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CACxF;YACE,KAAK;YACL,MAAM;SACP,CACF,EAAE,CAAC;QACJ,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CACxE;gBACE,KAAK;gBACL,MAAM;aACP,CACF,EAAE,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAuB;QACjC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AAUD,MAAM,UAAU,GAAG,CACjB,IAAU,EACV,OAAmB,EACnB,QAAsB,EACtB,aAA0B;IAE1B,OAAO,SAAS,CAAC,IAAI,CAAC;QACpB,IAAI;QACJ,OAAO;QACP,QAAQ;QACR,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"set.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/update/set.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAgB,MAAM,qBAAqB,CAAC;AAsBzD,MAAM,OAAO,SAAS;IACH,MAAM,CAAkB;IAEzC,YAAoB,MAAuB;QACzC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,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,IAAI,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,CACxF;YACE,KAAK;YACL,MAAM;SACP,CACF,EAAE,CAAC;QACJ,IAAI,UAAU,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,EAAE,CAAC;YAC9D,MAAM,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CACxE;gBACE,KAAK;gBACL,MAAM;aACP,CACF,EAAE,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,MAAuB;QACjC,OAAO,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC/B,CAAC;CACF;AAUD,MAAM,UAAU,GAAG,CACjB,OAAgB,EAChB,OAAmB,EACnB,QAAsB,EACtB,aAA0B;IAE1B,OAAO,SAAS,CAAC,IAAI,CAAC;QACpB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAC7B,OAAO;QACP,QAAQ;QACR,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/aws-dynamodb",
-  "version": "0.28.0-alpha.0",
+  "version": "0.29.0-alpha.0",
   "description": "A convenience wrapper over @aws-sdk/client-dynamodb and @aws-sdk/lib-dynamodb.",
   "keywords": [
     "aws",