@infra-blocks/aws-dynamodb 0.64.0 → 0.65.0

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

@@ -1,9 +1,10 @@
-import type { AttributeValue } from "../../../types.js";
-import { type Operand, type RawOperand } from "../operands/index.js";
-import type { ConditionComparisonParams } from "./comparisons.js";
-import type { ConditionExpression } from "./expression.js";
-import { type Size } from "./size.js";
-export type ConditionParams = ConditionExpression | ConditionComparisonParams;
-export type ConditionOperand<T extends AttributeValue = AttributeValue> = Operand<T> | Size;
-export type RawConditionOperand<T extends AttributeValue = AttributeValue> = RawOperand<T> | Size;
-export declare function conditionOperand<T extends AttributeValue = AttributeValue>(raw: RawConditionOperand<T>): ConditionOperand<T>;
+import type { AttributeExists, AttributeNotExists, BeginsWith, Contains, IsAttributeOfType } from "../functions/index.js";
+import { ConditionComparison, type ConditionComparisonParams } from "./condition-comparison.js";
+import type { And, Not, Or } from "./logic.js";
+export type ConditionParams = ConditionComparisonParams | ConditionFunction | ConditionLogic;
+export type ConditionFunction = AttributeExists | AttributeNotExists | BeginsWith | IsAttributeOfType | Contains;
+export type ConditionLogic = And | Not | Or;
+export type Condition = ConditionComparison | ConditionFunction | ConditionLogic;
+export declare const Condition: {
+    from(params: ConditionParams): Condition;
+};

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

@@ -1,12 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.conditionOperand = conditionOperand;
-const index_js_1 = require("../operands/index.js");
-const size_js_1 = require("./size.js");
-function conditionOperand(raw) {
-    if ((0, size_js_1.isSize)(raw)) {
-        return raw;
-    }
-    return (0, index_js_1.operand)(raw);
-}
+exports.Condition = void 0;
+const condition_comparison_js_1 = require("./condition-comparison.js");
+exports.Condition = {
+    from(params) {
+        if ((0, condition_comparison_js_1.isConditionComparisonParams)(params)) {
+            return condition_comparison_js_1.ConditionComparison.from(params);
+        }
+        return params;
+    },
+};
 //# sourceMappingURL=condition.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/condition.ts"],"names":[],"mappings":";;AAgBA,4CAOC;AAtBD,mDAA8E;AAG9E,uCAA8C;AAY9C,SAAgB,gBAAgB,CAC9B,GAA2B;IAE3B,IAAI,IAAA,gBAAM,EAAC,GAAG,CAAC,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,IAAA,kBAAO,EAAI,GAAG,CAAC,CAAC;AACzB,CAAC"}
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/condition.ts"],"names":[],"mappings":";;;AAOA,uEAImC;AAsBtB,QAAA,SAAS,GAAG;IACvB,IAAI,CAAC,MAAuB;QAC1B,IAAI,IAAA,qDAA2B,EAAC,MAAM,CAAC,EAAE,CAAC;YACxC,OAAO,6CAAmB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF,CAAC"}

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

@@ -1,5 +1,4 @@
-export type { Between, ComparableOperand, ComparableValue, ConditionComparisonParams, Equals, GreaterThan, GreaterThanOrEquals, In, LowerThan, LowerThanOrEquals, NotEquals, } from "./comparisons.js";
+export type { BetweenParams, ComparableOperand, ComparableValue, EqualsParams, GreaterThanOrEqualsParams, GreaterThanParams, InParams, LowerThanOrEqualsParams, LowerThanParams, NotEqualsParams, } from "./comparisons/index.js";
 export * from "./condition.js";
-export * from "./functions.js";
+export type { ConditionComparisonParams } from "./condition-comparison.js";
 export * from "./logic.js";
-export * from "./size.js";

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

@@ -15,7 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./condition.js"), exports);
-__exportStar(require("./functions.js"), exports);
 __exportStar(require("./logic.js"), exports);
-__exportStar(require("./size.js"), exports);
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAaA,iDAA+B;AAC/B,iDAA+B;AAC/B,6CAA2B;AAC3B,4CAA0B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAYA,iDAA+B;AAE/B,6CAA2B"}

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

@@ -1,34 +1,38 @@
-import type { ConditionParams } from "./condition.js";
-import { ConditionExpression } from "./expression.js";
+import { type Brand } from "@infra-blocks/types";
+import { ExpressionFormatter } from "../expression.js";
+import { type ConditionParams } from "./condition.js";
+export type Not = ExpressionFormatter & Brand<"Not">;
 /**
  * Negates the provided condition using the `NOT` operator.
  *
  * @param condition - The condition to negate.
  *
- * @returns A {@link ConditionExpression} that evaluates to the opposite of what the provided condition evaluates to.
+ * @returns A {@link Not} that evaluates to the opposite of what the provided condition evaluates to.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
-export declare function not(condition: ConditionParams): ConditionExpression;
+export declare function not(condition: ConditionParams): Not;
+export type And = ExpressionFormatter & Brand<"And">;
 /**
  * Returns a condition that combines the provided ones using the `AND` operator.
  *
  * @param lhs - The first condition to combine.
  * @param rhs - The second condition to combine.
  *
- * @returns A {@link ConditionExpression} that evaluates to true only if both conditions evaluate to true.
+ * @returns An {@link And} that evaluates to true only if both conditions evaluate to true.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
-export declare function and(lhs: ConditionParams, rhs: ConditionParams): ConditionExpression;
+export declare function and(lhs: ConditionParams, rhs: ConditionParams): And;
+export type Or = ExpressionFormatter & Brand<"Or">;
 /**
  * Returns a condition that combines the provided ones using the `OR` operator.
  *
  * @param lhs - The first condition to combine.
  * @param rhs - The second condition to combine.
  *
- * @returns A {@link ConditionExpression} that evaluates to true if any conditions evaluate to true.
+ * @returns An {@link Or} that evaluates to true if any conditions evaluate to true.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
-export declare function or(lhs: ConditionParams, rhs: ConditionParams): ConditionExpression;
+export declare function or(lhs: ConditionParams, rhs: ConditionParams): Or;

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

@@ -3,23 +3,21 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.not = not;
 exports.and = and;
 exports.or = or;
-const expression_js_1 = require("./expression.js");
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const condition_js_1 = require("./condition.js");
 /**
  * Negates the provided condition using the `NOT` operator.
  *
  * @param condition - The condition to negate.
  *
- * @returns A {@link ConditionExpression} that evaluates to the opposite of what the provided condition evaluates to.
+ * @returns A {@link Not} that evaluates to the opposite of what the provided condition evaluates to.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
 function not(condition) {
-    const expression = (0, expression_js_1.conditionExpression)(condition);
-    return expression_js_1.ConditionExpression.from({
-        stringify: ({ names, values }) => {
-            return `(NOT ${expression.stringify({ names, values })})`;
-        },
-    });
+    const expression = condition_js_1.Condition.from(condition);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `(NOT ${expression.format({ names, values })})`));
 }
 /**
  * Returns a condition that combines the provided ones using the `AND` operator.
@@ -27,21 +25,17 @@ function not(condition) {
  * @param lhs - The first condition to combine.
  * @param rhs - The second condition to combine.
  *
- * @returns A {@link ConditionExpression} that evaluates to true only if both conditions evaluate to true.
+ * @returns An {@link And} that evaluates to true only if both conditions evaluate to true.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
 function and(lhs, rhs) {
-    const left = (0, expression_js_1.conditionExpression)(lhs);
-    const right = (0, expression_js_1.conditionExpression)(rhs);
-    return expression_js_1.ConditionExpression.from({
-        stringify: ({ names, values }) => {
-            return `(${left.stringify({ names, values })} AND ${right.stringify({
-                names,
-                values,
-            })})`;
-        },
-    });
+    const left = condition_js_1.Condition.from(lhs);
+    const right = condition_js_1.Condition.from(rhs);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `(${left.format({ names, values })} AND ${right.format({
+        names,
+        values,
+    })})`));
 }
 /**
  * Returns a condition that combines the provided ones using the `OR` operator.
@@ -49,20 +43,16 @@ function and(lhs, rhs) {
  * @param lhs - The first condition to combine.
  * @param rhs - The second condition to combine.
  *
- * @returns A {@link ConditionExpression} that evaluates to true if any conditions evaluate to true.
+ * @returns An {@link Or} that evaluates to true if any conditions evaluate to true.
  *
  * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.LogicalEvaluations
  */
 function or(lhs, rhs) {
-    const left = (0, expression_js_1.conditionExpression)(lhs);
-    const right = (0, expression_js_1.conditionExpression)(rhs);
-    return expression_js_1.ConditionExpression.from({
-        stringify: ({ names, values }) => {
-            return `(${left.stringify({ names, values })} OR ${right.stringify({
-                names,
-                values,
-            })})`;
-        },
-    });
+    const left = condition_js_1.Condition.from(lhs);
+    const right = condition_js_1.Condition.from(rhs);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `(${left.format({ names, values })} OR ${right.format({
+        names,
+        values,
+    })})`));
 }
 //# sourceMappingURL=logic.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"logic.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/logic.ts"],"names":[],"mappings":";;AAYA,kBAOC;AAYD,kBAcC;AAYD,gBAcC;AAtED,mDAA2E;AAE3E;;;;;;;;GAQG;AACH,SAAgB,GAAG,CAAC,SAA0B;IAC5C,MAAM,UAAU,GAAG,IAAA,mCAAmB,EAAC,SAAS,CAAC,CAAC;IAClD,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/B,OAAO,QAAQ,UAAU,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC;QAC5D,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,GAAG,CACjB,GAAoB,EACpB,GAAoB;IAEpB,MAAM,IAAI,GAAG,IAAA,mCAAmB,EAAC,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAA,mCAAmB,EAAC,GAAG,CAAC,CAAC;IACvC,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/B,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,QAAQ,KAAK,CAAC,SAAS,CAAC;gBAClE,KAAK;gBACL,MAAM;aACP,CAAC,GAAG,CAAC;QACR,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,SAAgB,EAAE,CAChB,GAAoB,EACpB,GAAoB;IAEpB,MAAM,IAAI,GAAG,IAAA,mCAAmB,EAAC,GAAG,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAA,mCAAmB,EAAC,GAAG,CAAC,CAAC;IACvC,OAAO,mCAAmB,CAAC,IAAI,CAAC;QAC9B,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE;YAC/B,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,KAAK,CAAC,SAAS,CAAC;gBACjE,KAAK;gBACL,MAAM;aACP,CAAC,GAAG,CAAC;QACR,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"logic.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/logic.ts"],"names":[],"mappings":";;AAeA,kBAOC;AAcD,kBAYC;AAcD,gBAYC;AA1ED,+CAA0D;AAC1D,oDAAuD;AACvD,iDAAiE;AAIjE;;;;;;;;GAQG;AACH,SAAgB,GAAG,CAAC,SAA0B;IAC5C,MAAM,UAAU,GAAG,wBAAS,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,QAAQ,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CACvE,CACF,CAAC;AACJ,CAAC;AAID;;;;;;;;;GASG;AACH,SAAgB,GAAG,CAAC,GAAoB,EAAE,GAAoB;IAC5D,MAAM,IAAI,GAAG,wBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,wBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,QAAQ,KAAK,CAAC,MAAM,CAAC;QACrD,KAAK;QACL,MAAM;KACP,CAAC,GAAG,CACR,CACF,CAAC;AACJ,CAAC;AAID;;;;;;;;;GASG;AACH,SAAgB,EAAE,CAAC,GAAoB,EAAE,GAAoB;IAC3D,MAAM,IAAI,GAAG,wBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACjC,MAAM,KAAK,GAAG,wBAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,OAAO,KAAK,CAAC,MAAM,CAAC;QACpD,KAAK;QACL,MAAM;KACP,CAAC,GAAG,CACR,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,8 @@
+import type { AttributeValue } from "../../../types.js";
+import { type Operand, type RawOperand } from "../operands/operand.js";
+import { type Size } from "../operands/size.js";
+export type ConditionOperand<T extends AttributeValue = AttributeValue> = Operand<T> | Size;
+export type RawConditionOperand<T extends AttributeValue = AttributeValue> = RawOperand<T> | Size;
+export declare const ConditionOperand: {
+    normalize<T extends AttributeValue = AttributeValue>(raw: RawConditionOperand<T>): ConditionOperand<T>;
+};

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConditionOperand = void 0;
+const operand_js_1 = require("../operands/operand.js");
+const size_js_1 = require("../operands/size.js");
+// TODO: internal
+exports.ConditionOperand = {
+    normalize(raw) {
+        if ((0, size_js_1.isSize)(raw)) {
+            return raw;
+        }
+        return (0, operand_js_1.operand)(raw);
+    },
+};
+//# sourceMappingURL=operand.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operand.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/condition/operand.ts"],"names":[],"mappings":";;;AACA,uDAAgF;AAChF,iDAAwD;AASxD,iBAAiB;AAEJ,QAAA,gBAAgB,GAAG;IAC9B,SAAS,CACP,GAA2B;QAE3B,IAAI,IAAA,gBAAM,EAAC,GAAG,CAAC,EAAE,CAAC;YAChB,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,IAAA,oBAAO,EAAI,GAAG,CAAC,CAAC;IACzB,CAAC;CACF,CAAC"}

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

@@ -1,12 +1,14 @@
-import type { AttributeNames } from "../attributes/names.js";
-import type { AttributeValues } from "../attributes/values.js";
-export type Stringifier = (params: {
+import type { AttributeNames, AttributeValues } from "../attributes/index.js";
+export type Formatter = (params: {
     names: AttributeNames;
     values: AttributeValues;
 }) => string;
-export interface IExpression {
-    stringify(params: {
+export type ExpressionFormatter = {
+    format(params: {
         names: AttributeNames;
         values: AttributeValues;
     }): string;
-}
+};
+export declare const ExpressionFormatter: {
+    from(formatter: Formatter): ExpressionFormatter;
+};

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

@@ -1,3 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExpressionFormatter = void 0;
+exports.ExpressionFormatter = {
+    from(formatter) {
+        return {
+            format: formatter,
+        };
+    },
+};
 //# sourceMappingURL=expression.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"expression.js","sourceRoot":"","sources":["../../../../src/commands/expressions/expression.ts"],"names":[],"mappings":""}
+{"version":3,"file":"expression.js","sourceRoot":"","sources":["../../../../src/commands/expressions/expression.ts"],"names":[],"mappings":";;;AAWa,QAAA,mBAAmB,GAAG;IACjC,IAAI,CAAC,SAAoB;QACvB,OAAO;YACL,MAAM,EAAE,SAAS;SAClB,CAAC;IACJ,CAAC;CACF,CAAC"}

package/lib/cjs/commands/expressions/functions/attribute-exists.d.ts

@@ -0,0 +1,13 @@
+import { type Brand } from "@infra-blocks/types";
+import { ExpressionFormatter } from "../expression.js";
+import { type RawPath } from "../operands/path.js";
+export type AttributeExists = ExpressionFormatter & Brand<"AttributeExists">;
+/**
+ * Returns a condition that uses the `attribute_exists` function.
+ *
+ * @param rawPath - The attribute path to check for existence.
+ * @returns An {@link AttributeExists} 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(rawPath: RawPath): AttributeExists;

package/lib/cjs/commands/expressions/functions/attribute-exists.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributeExists = attributeExists;
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const path_js_1 = require("../operands/path.js");
+/**
+ * Returns a condition that uses the `attribute_exists` function.
+ *
+ * @param rawPath - The attribute path to check for existence.
+ * @returns An {@link AttributeExists} 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(rawPath) {
+    const path = path_js_1.Path.normalize(rawPath);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names }) => `attribute_exists(${path.substitute({ names })})`));
+}
+//# sourceMappingURL=attribute-exists.js.map

package/lib/cjs/commands/expressions/functions/attribute-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/attribute-exists.ts"],"names":[],"mappings":";;AAcA,0CAOC;AArBD,+CAA0D;AAC1D,oDAAuD;AACvD,iDAAyD;AAIzD;;;;;;;GAOG;AACH,SAAgB,eAAe,CAAC,OAAgB;IAC9C,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,oBAAoB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CACjE,CACF,CAAC;AACJ,CAAC"}

package/lib/cjs/commands/expressions/functions/attribute-not-exists.d.ts

@@ -0,0 +1,13 @@
+import { type Brand } from "@infra-blocks/types";
+import { ExpressionFormatter } from "../expression.js";
+import { type RawPath } from "../operands/path.js";
+export type AttributeNotExists = ExpressionFormatter & Brand<"AttributeNotExists">;
+/**
+ * Returns a condition that uses the `attribute_not_exists` function.
+ *
+ * @param rawPath - The attribute path to check for non-existence.
+ * @returns An {@link AttributeNotExists} 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(rawPath: RawPath): AttributeNotExists;

package/lib/cjs/commands/expressions/functions/attribute-not-exists.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributeNotExists = attributeNotExists;
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const path_js_1 = require("../operands/path.js");
+/**
+ * Returns a condition that uses the `attribute_not_exists` function.
+ *
+ * @param rawPath - The attribute path to check for non-existence.
+ * @returns An {@link AttributeNotExists} 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(rawPath) {
+    const path = path_js_1.Path.normalize(rawPath);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names }) => `attribute_not_exists(${path.substitute({ names })})`));
+}
+//# sourceMappingURL=attribute-not-exists.js.map

package/lib/cjs/commands/expressions/functions/attribute-not-exists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-not-exists.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/attribute-not-exists.ts"],"names":[],"mappings":";;AAeA,gDAOC;AAtBD,+CAA0D;AAC1D,oDAAuD;AACvD,iDAAyD;AAKzD;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,OAAgB;IACjD,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,wBAAwB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CACrE,CACF,CAAC;AACJ,CAAC"}

package/lib/cjs/commands/expressions/functions/attribute-type.d.ts

@@ -0,0 +1,17 @@
+import { type Brand } from "@infra-blocks/types";
+import type { AttributeType } from "../../../types.js";
+import { ExpressionFormatter } from "../expression.js";
+import { type RawPath } from "../operands/path.js";
+import { type RawValue } from "../operands/value.js";
+export type IsAttributeOfType = ExpressionFormatter & Brand<"IsAttributeOfType">;
+/**
+ * Returns a condition that uses the `attribute_type` function.
+ *
+ * @param attribute - The attribute path to check.
+ * @param rawType - The expected type of the attribute.
+ *
+ * @returns An {@link IsAttributeOfType} that evaluates to true if the attribute is of the expected type.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+export declare function attributeType(attribute: RawPath, rawType: RawValue<AttributeType>): IsAttributeOfType;

package/lib/cjs/commands/expressions/functions/attribute-type.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attributeType = attributeType;
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const path_js_1 = require("../operands/path.js");
+const value_js_1 = require("../operands/value.js");
+/**
+ * Returns a condition that uses the `attribute_type` function.
+ *
+ * @param attribute - The attribute path to check.
+ * @param rawType - The expected type of the attribute.
+ *
+ * @returns An {@link IsAttributeOfType} that evaluates to true if the attribute is of the expected type.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+function attributeType(attribute, rawType) {
+    const path = path_js_1.Path.normalize(attribute);
+    const type = value_js_1.Value.normalize(rawType);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `attribute_type(${path.substitute({ names })}, ${type.substitute({ values })})`));
+}
+//# sourceMappingURL=attribute-type.js.map

package/lib/cjs/commands/expressions/functions/attribute-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attribute-type.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/attribute-type.ts"],"names":[],"mappings":";;AAoBA,sCAYC;AAhCD,+CAA0D;AAE1D,oDAAuD;AACvD,iDAAyD;AACzD,mDAA4D;AAM5D;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAC3B,SAAkB,EAClB,OAAgC;IAEhC,MAAM,IAAI,GAAG,cAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,gBAAK,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACtC,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,kBAAkB,IAAI,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG,CAClF,CACF,CAAC;AACJ,CAAC"}

package/lib/cjs/commands/expressions/functions/begins-with.d.ts

@@ -0,0 +1,24 @@
+import { type Brand } from "@infra-blocks/types";
+import type { NativeBinary, NativeString } from "../../../types.js";
+import { ExpressionFormatter } from "../expression.js";
+import { type RawOperand } from "../operands/operand.js";
+/**
+ * This type aggregates the types of operands that can be used with the {@link beginsWith} function.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+export type BeginsWithOperand = RawOperand<StringOrBinary>;
+export type BeginsWith = ExpressionFormatter & Brand<"BeginsWith">;
+/**
+ * Returns a condition that uses the `begins_with` function.
+ *
+ * @param first - The first function operand, which is the path or value to check.
+ * @param second - The second function operand, which is the prefix to validate against.
+ *
+ * @returns A {@link BeginsWith} that evaluates to true if the first operand begins with the second.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+export declare function beginsWith(first: BeginsWithOperand, second: BeginsWithOperand): BeginsWith;
+type StringOrBinary = NativeString | NativeBinary;
+export {};

package/lib/cjs/commands/expressions/functions/begins-with.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.beginsWith = beginsWith;
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const operand_js_1 = require("../operands/operand.js");
+/**
+ * Returns a condition that uses the `begins_with` function.
+ *
+ * @param first - The first function operand, which is the path or value to check.
+ * @param second - The second function operand, which is the prefix to validate against.
+ *
+ * @returns A {@link BeginsWith} that evaluates to true if the first operand begins with the second.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+function beginsWith(first, second) {
+    const firstOperand = (0, operand_js_1.operand)(first);
+    const secondOperand = (0, operand_js_1.operand)(second);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `begins_with(${firstOperand.substitute({ names, values })}, ${secondOperand.substitute({ names, values })})`));
+}
+//# sourceMappingURL=begins-with.js.map

package/lib/cjs/commands/expressions/functions/begins-with.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"begins-with.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/begins-with.ts"],"names":[],"mappings":";;AAwBA,gCAaC;AArCD,+CAA0D;AAE1D,oDAAuD;AACvD,uDAAkE;AAWlE;;;;;;;;;GASG;AACH,SAAgB,UAAU,CACxB,KAAwB,EACxB,MAAyB;IAEzB,MAAM,YAAY,GAAG,IAAA,oBAAO,EAAiB,KAAK,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,IAAA,oBAAO,EAAiB,MAAM,CAAC,CAAC;IAEtD,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,eAAe,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CAC/G,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,16 @@
+import { type Brand } from "@infra-blocks/types";
+import { ExpressionFormatter } from "../expression.js";
+import { type RawOperand } from "../operands/operand.js";
+import { type Size } from "../operands/size.js";
+export type Contains = ExpressionFormatter & Brand<"Contains">;
+/**
+ * Returns a condition that uses the `contains` function.
+ *
+ * @param first - The first function operand, which is the path or value to check.
+ * @param second - The second function operand, which is the value to check for containment.
+ *
+ * @returns A {@link ConditionExpressionFormatter} that evaluates to true if this operand contains the provided one.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+export declare function contains(first: RawOperand, second: RawOperand | Size): Contains;

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

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contains = contains;
+const types_1 = require("@infra-blocks/types");
+const expression_js_1 = require("../expression.js");
+const operand_js_1 = require("../operands/operand.js");
+const size_js_1 = require("../operands/size.js");
+/**
+ * Returns a condition that uses the `contains` function.
+ *
+ * @param first - The first function operand, which is the path or value to check.
+ * @param second - The second function operand, which is the value to check for containment.
+ *
+ * @returns A {@link ConditionExpressionFormatter} that evaluates to true if this operand contains the provided one.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+ */
+function contains(first, second) {
+    const firstOperand = (0, operand_js_1.operand)(first);
+    const secondOperand = (0, size_js_1.isSize)(second) ? second : (0, operand_js_1.operand)(second);
+    return (0, types_1.trusted)(expression_js_1.ExpressionFormatter.from(({ names, values }) => `contains(${firstOperand.substitute({ names, values })}, ${secondOperand.substitute({ names, values })})`));
+}
+//# sourceMappingURL=contains.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"contains.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/contains.ts"],"names":[],"mappings":";;AAiBA,4BAaC;AA9BD,+CAA0D;AAC1D,oDAAuD;AACvD,uDAAkE;AAClE,iDAAwD;AAIxD;;;;;;;;;GASG;AACH,SAAgB,QAAQ,CACtB,KAAiB,EACjB,MAAyB;IAEzB,MAAM,YAAY,GAAG,IAAA,oBAAO,EAAC,KAAK,CAAC,CAAC;IACpC,MAAM,aAAa,GAAG,IAAA,gBAAM,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,oBAAO,EAAC,MAAM,CAAC,CAAC;IAEhE,OAAO,IAAA,eAAO,EACZ,mCAAmB,CAAC,IAAI,CACtB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CACpB,YAAY,YAAY,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,KAAK,aAAa,CAAC,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,GAAG,CAC5G,CACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export * from "./attribute-exists.js";
+export * from "./attribute-not-exists.js";
+export * from "./attribute-type.js";
+export * from "./begins-with.js";
+export * from "./contains.js";

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/functions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,4DAA0C;AAC1C,sDAAoC;AACpC,mDAAiC;AACjC,gDAA8B"}

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

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

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

@@ -15,6 +15,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./condition/index.js"), exports);
+__exportStar(require("./functions/index.js"), exports);
 __exportStar(require("./key-condition.js"), exports);
 __exportStar(require("./operands/index.js"), exports);
 __exportStar(require("./projection.js"), exports);

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,uDAAqC;AACrC,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,oDAAkC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/expressions/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,uDAAqC;AACrC,uDAAqC;AACrC,qDAAmC;AACnC,sDAAoC;AACpC,kDAAgC;AAChC,oDAAkC"}

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

@@ -1,2 +1,2 @@
 import type { ConditionParams } from "./condition/index.js";
-export type KeyConditionExpression = ConditionParams;
+export type KeyConditionParams = ConditionParams;

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

@@ -1,3 +1,4 @@
 export { type ImplicitOperand, type Operand, operand, type RawOperand, } from "./operand.js";
 export { type ImplicitPath, literal, Path, path, type RawPath, } from "./path.js";
+export { type RawSizeOperand, type SizeOperand, type SizeOperandValue, size, } from "./size.js";
 export { type ImplicitValue, type RawValue, Value, value, } from "./value.js";

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

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.value = exports.Value = exports.path = exports.Path = exports.literal = exports.operand = void 0;
+exports.value = exports.Value = exports.size = exports.path = exports.Path = exports.literal = exports.operand = void 0;
 var operand_js_1 = require("./operand.js");
 Object.defineProperty(exports, "operand", { enumerable: true, get: function () { return operand_js_1.operand; } });
 var path_js_1 = require("./path.js");
 Object.defineProperty(exports, "literal", { enumerable: true, get: function () { return path_js_1.literal; } });
 Object.defineProperty(exports, "Path", { enumerable: true, get: function () { return path_js_1.Path; } });
 Object.defineProperty(exports, "path", { enumerable: true, get: function () { return path_js_1.path; } });
+var size_js_1 = require("./size.js");
+Object.defineProperty(exports, "size", { enumerable: true, get: function () { return size_js_1.size; } });
 var value_js_1 = require("./value.js");
 Object.defineProperty(exports, "Value", { enumerable: true, get: function () { return value_js_1.Value; } });
 Object.defineProperty(exports, "value", { enumerable: true, get: function () { return value_js_1.value; } });

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/index.ts"],"names":[],"mappings":";;;AAAA,2CAKsB;AAFpB,qGAAA,OAAO,OAAA;AAGT,qCAMmB;AAJjB,kGAAA,OAAO,OAAA;AACP,+FAAA,IAAI,OAAA;AACJ,+FAAA,IAAI,OAAA;AAGN,uCAKoB;AAFlB,iGAAA,KAAK,OAAA;AACL,iGAAA,KAAK,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/commands/expressions/operands/index.ts"],"names":[],"mappings":";;;AAAA,2CAKsB;AAFpB,qGAAA,OAAO,OAAA;AAGT,qCAMmB;AAJjB,kGAAA,OAAO,OAAA;AACP,+FAAA,IAAI,OAAA;AACJ,+FAAA,IAAI,OAAA;AAGN,qCAKmB;AADjB,+FAAA,IAAI,OAAA;AAEN,uCAKoB;AAFlB,iGAAA,KAAK,OAAA;AACL,iGAAA,KAAK,OAAA"}