@infra-blocks/aws-dynamodb 0.15.0-alpha.2 → 0.16.0-alpha.0

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

@@ -1,2 +1,213 @@
-import type { Expression } from "./expression.js";
-export type ConditionExpression = Expression;
+import type { AttributeType } from "../../types.js";
+import type { AttributeNames } from "../attributes/names.js";
+import type { AttributeValues } from "../attributes/values.js";
+import { AttributeOperand, type IOperand, type Operand, type ValueOperand } from "./operands.js";
+export type ConditionOperand = Operand | SizeOperand;
+export type Stringifier = (params: {
+    names: AttributeNames;
+    values: AttributeValues;
+}) => string;
+export interface ConditionParams {
+    stringify: Stringifier;
+}
+export declare class Condition {
+    private readonly stringifier;
+    constructor(params: ConditionParams);
+    stringify(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+    /**
+     * Returns a condition that combines this one with the provided condition using the `AND` operator.
+     *
+     * @param other - The other condition to combine with this one.
+     *
+     * @returns A {@link Condition} 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
+     */
+    and(other: Condition): Condition;
+    /**
+     * Returns a condition that combines this one with the provided condition using the `OR` operator.
+     *
+     * @param other - The other condition to combine with this one.
+     *
+     * @returns A {@link Condition} 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
+     */
+    or(other: Condition): Condition;
+}
+/**
+ * Negates the provided condition using the `NOT` operator.
+ *
+ * @param inner - The condition to negate.
+ *
+ * @returns A {@link Condition} 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(inner: Condition): Condition;
+export declare class OperandConditionBuilder<T extends Operand> {
+    protected readonly operand: T;
+    constructor(operand: T);
+    /**
+     * Returns a condition that uses the `begins_with` function.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand begins with the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+     */
+    beginsWith(rhs: Operand<string>): Condition;
+    /**
+     * Returns a condition that uses the `BETWEEN` operator.
+     *
+     * Both bounds are inclusive, meaning that the returned condition corresponds to `lower <= this <= upper`.
+     *
+     * @param lower - The lower inclusive bound of the range.
+     * @param upper - The upper inclusive bound of the range.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is within the provided bounds.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    between(lower: ConditionOperand, upper: ConditionOperand): Condition;
+    /**
+     * Returns a condition that uses the `contains` function.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} 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
+     */
+    contains(rhs: ConditionOperand): Condition;
+    /**
+     * Returns a condition that uses the `=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    equals(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link equals}.
+     */
+    eq: (rhs: ConditionOperand) => Condition;
+    /**
+     * Returns a condition that uses the `>` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is greater than the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    greaterThan(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link greaterThan}.
+     */
+    gt: (rhs: ConditionOperand) => Condition;
+    /**
+     * Returns a condition that uses the `>=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is greater than or equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    greaterThanOrEquals(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link greaterThanOrEquals}
+     */
+    gte: (rhs: ConditionOperand) => Condition;
+    /**
+     * Returns a condition that uses the `IN` operator.
+     *
+     * @param operands - The list of operands to check against. This function throws if the list is
+     * empty or contains more than 100 operands.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is equal to any of the provided ones.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    in(...operands: ConditionOperand[]): Condition;
+    /**
+     * Returns a condition that uses the `<` operator
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is lower than the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    lowerThan(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link lowerThan}.
+     */
+    lt: (rhs: ConditionOperand) => Condition;
+    /**
+     * Returns a condition that uses the `<=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is lower than or equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    lowerThanOrEquals(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link lowerThanOrEquals}
+     */
+    lte: (rhs: ConditionOperand) => Condition;
+    /**
+     * Returns a condition that uses the `<>` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is not equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    notEquals(rhs: ConditionOperand): Condition;
+    /**
+     * An alias for {@link notEquals}.
+     */
+    ne: (rhs: ConditionOperand) => Condition;
+    protected substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare class AttributeConditionBuilder extends OperandConditionBuilder<AttributeOperand> {
+    /**
+     * @returns A {@link Condition} that evaluates to true if the provided attribute path exists.
+     */
+    exists(): Condition;
+    /**
+     * @returns A {@link Condition} that evaluates to true if the provided attribute path does not exist.
+     */
+    notExists(): Condition;
+    /**
+     * @param type - The type to check against.
+     * @returns A {@link Condition} that evaluates to true if there exists an attribute at
+     * the provided path of the given type.
+     */
+    isType(type: ValueOperand<AttributeType>): Condition;
+}
+export declare function where(attrribute: AttributeOperand): AttributeConditionBuilder;
+export declare function where(operand: Exclude<Operand, AttributeOperand>): OperandConditionBuilder<Exclude<Operand, AttributeOperand>>;
+export declare class SizeOperand implements IOperand {
+    private readonly inner;
+    constructor(operand: Operand);
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare function size(operand: Operand): SizeOperand;

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

@@ -1,3 +1,352 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SizeOperand = exports.AttributeConditionBuilder = exports.OperandConditionBuilder = exports.Condition = void 0;
+exports.not = not;
+exports.where = where;
+exports.size = size;
+const operands_js_1 = require("./operands.js");
+class Condition {
+    stringifier;
+    constructor(params) {
+        const { stringify } = params;
+        this.stringifier = stringify;
+    }
+    // TODO: exclude from exported type definitions if possible.
+    stringify(params) {
+        return this.stringifier(params);
+    }
+    /**
+     * Returns a condition that combines this one with the provided condition using the `AND` operator.
+     *
+     * @param other - The other condition to combine with this one.
+     *
+     * @returns A {@link Condition} 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
+     */
+    and(other) {
+        return condition({
+            stringify: ({ names, values }) => {
+                const left = this.stringify({ names, values });
+                const right = other.stringify({ names, values });
+                return `(${left} AND ${right})`;
+            },
+        });
+    }
+    /**
+     * Returns a condition that combines this one with the provided condition using the `OR` operator.
+     *
+     * @param other - The other condition to combine with this one.
+     *
+     * @returns A {@link Condition} 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
+     */
+    or(other) {
+        return condition({
+            stringify: ({ names, values }) => {
+                const left = this.stringify({ names, values });
+                const right = other.stringify({ names, values });
+                return `(${left} OR ${right})`;
+            },
+        });
+    }
+}
+exports.Condition = Condition;
+/**
+ * Negates the provided condition using the `NOT` operator.
+ *
+ * @param inner - The condition to negate.
+ *
+ * @returns A {@link Condition} 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(inner) {
+    return condition({
+        stringify: ({ names, values }) => {
+            return `NOT (${inner.stringify({ names, values })})`;
+        },
+    });
+}
+// TODO: make this a static factory?
+function condition(params) {
+    return new Condition(params);
+}
+// NOTE: methods here means that both sides of the conditions can either be attribute names or attribute values.
+class OperandConditionBuilder {
+    operand;
+    constructor(operand) {
+        this.operand = operand;
+    }
+    /**
+     * Returns a condition that uses the `begins_with` function.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand begins with the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions
+     */
+    beginsWith(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `begins_with(${this.substitute({ names, values })}, ${rhs.substitute({ names, values })})`;
+            },
+        });
+    }
+    /**
+     * Returns a condition that uses the `BETWEEN` operator.
+     *
+     * Both bounds are inclusive, meaning that the returned condition corresponds to `lower <= this <= upper`.
+     *
+     * @param lower - The lower inclusive bound of the range.
+     * @param upper - The upper inclusive bound of the range.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is within the provided bounds.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: test with size operands.
+    between(lower, upper) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} BETWEEN ${lower.substitute({ names, values })} AND ${upper.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * Returns a condition that uses the `contains` function.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} 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
+     */
+    // TODO: test with size operands.
+    contains(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `contains(${this.substitute({ names, values })}, ${rhs.substitute({ names, values })})`;
+            },
+        });
+    }
+    /**
+     * Returns a condition that uses the `=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: this should be typed better once moved out. It accepts the interface only to make the tests compile.
+    equals(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} = ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link equals}.
+     */
+    eq = this.equals.bind(this);
+    /**
+     * Returns a condition that uses the `>` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is greater than the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: test that both sides can be size manually, then add the unit tests if it makes sense.
+    greaterThan(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} > ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link greaterThan}.
+     */
+    gt = this.greaterThan.bind(this);
+    /**
+     * Returns a condition that uses the `>=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is greater than or equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: test that both sides can be size manually, then add the unit tests if it makes sense.
+    greaterThanOrEquals(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} >= ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link greaterThanOrEquals}
+     */
+    gte = this.greaterThanOrEquals.bind(this);
+    /**
+     * Returns a condition that uses the `IN` operator.
+     *
+     * @param operands - The list of operands to check against. This function throws if the list is
+     * empty or contains more than 100 operands.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is equal to any of the provided ones.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: test that both sides can be size manually, then add the unit tests if it makes sense.
+    in(...operands) {
+        if (operands.length === 0) {
+            throw new Error("the IN operator requires at least one operand.");
+        }
+        if (operands.length > 100) {
+            throw new Error(`up to 100 operands are support for the IN operator, got ${operands.length}`);
+        }
+        return condition({
+            stringify: ({ names, values }) => {
+                const operandsString = operands
+                    .map((operand) => operand.substitute({ names, values }))
+                    .join(",");
+                return `${this.substitute({ names, values })} IN (${operandsString})`;
+            },
+        });
+    }
+    /**
+     * Returns a condition that uses the `<` operator
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is lower than the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    // TODO: test that both sides can be size manually, then add the unit tests if it makes sense.
+    lowerThan(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} < ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link lowerThan}.
+     */
+    lt = this.lowerThan.bind(this);
+    /**
+     * Returns a condition that uses the `<=` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is lower than or equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    //TODO: test that both sides can be size manually, then add the unit tests if it makes sense.
+    lowerThanOrEquals(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} <= ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link lowerThanOrEquals}
+     */
+    lte = this.lowerThanOrEquals.bind(this);
+    /**
+     * Returns a condition that uses the `<>` operator.
+     *
+     * @param rhs - The right hand side operand.
+     *
+     * @returns A {@link Condition} that evaluates to true if this operand is not equal to the provided one.
+     *
+     * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators
+     */
+    notEquals(rhs) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `${this.substitute({ names, values })} <> ${rhs.substitute({ names, values })}`;
+            },
+        });
+    }
+    /**
+     * An alias for {@link notEquals}.
+     */
+    ne = this.notEquals.bind(this);
+    substitute(params) {
+        return this.operand.substitute(params);
+    }
+}
+exports.OperandConditionBuilder = OperandConditionBuilder;
+// A specialized class with more capabilities.
+class AttributeConditionBuilder extends OperandConditionBuilder {
+    /**
+     * @returns A {@link Condition} that evaluates to true if the provided attribute path exists.
+     */
+    // NOTE: the left hand side of this condition can only be a literal value (tested)
+    exists() {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `attribute_exists(${this.substitute({ names, values })})`;
+            },
+        });
+    }
+    /**
+     * @returns A {@link Condition} that evaluates to true if the provided attribute path does not exist.
+     */
+    // NOTE: the left hand side of this condition can only be a literal value (tested)
+    notExists() {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `attribute_not_exists(${this.substitute({ names, values })})`;
+            },
+        });
+    }
+    /**
+     * @param type - The type to check against.
+     * @returns A {@link Condition} that evaluates to true if there exists an attribute at
+     * the provided path of the given type.
+     */
+    // NOTE: the left hand side of this condition *can be* an attribute value pointing to a valid path.
+    // NOTE: the right hand side of this condition *must be* an condition attribute (not a literal).
+    isType(type) {
+        return condition({
+            stringify: ({ names, values }) => {
+                return `attribute_type(${this.substitute({ names, values })}, ${type.substitute({ names, values })})`;
+            },
+        });
+    }
+}
+exports.AttributeConditionBuilder = AttributeConditionBuilder;
+function where(operand) {
+    if (operand instanceof operands_js_1.AttributeOperand) {
+        return new AttributeConditionBuilder(operand);
+    }
+    return new OperandConditionBuilder(operand);
+}
+// TODO: type this as a "value operand" of type number if possiburu or useful?
+class SizeOperand {
+    inner;
+    constructor(operand) {
+        this.inner = operand;
+    }
+    substitute(params) {
+        return `size(${this.inner.substitute(params)})`;
+    }
+}
+exports.SizeOperand = SizeOperand;
+function size(operand) {
+    return new SizeOperand(operand);
+}
 //# sourceMappingURL=condition.js.map

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

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

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

@@ -1,2 +1,3 @@
-export * from "./expression.js";
+export * from "./condition.js";
 export * from "./key-condition.js";
+export * from "./operands.js";

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

@@ -14,6 +14,7 @@ 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("./expression.js"), exports);
+__exportStar(require("./condition.js"), exports);
 __exportStar(require("./key-condition.js"), exports);
+__exportStar(require("./operands.js"), exports);
 //# sourceMappingURL=index.js.map

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

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

@@ -1,2 +1,2 @@
-import type { Expression } from "./expression.js";
-export type KeyConditionExpression = Expression;
+import type { Condition } from "./condition.js";
+export type KeyConditionExpression = Condition;

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

@@ -0,0 +1,28 @@
+import type { AttributePath, AttributeValue } from "../../types.js";
+import type { AttributeNames } from "../attributes/names.js";
+import type { AttributeValues } from "../attributes/values.js";
+export type Operand<T extends AttributeValue = AttributeValue> = AttributeOperand | ValueOperand<T>;
+export interface IOperand {
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare class ValueOperand<T extends AttributeValue> implements IOperand {
+    private readonly value;
+    constructor(value: T);
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare function value<T extends AttributeValue = AttributeValue>(value: AttributeValue): ValueOperand<T>;
+export declare class AttributeOperand implements IOperand {
+    private readonly path;
+    constructor(path: AttributePath);
+    substitute(params: {
+        names: AttributeNames;
+        values: AttributeValues;
+    }): string;
+}
+export declare function attribute(path: AttributePath): AttributeOperand;

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

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttributeOperand = exports.ValueOperand = void 0;
+exports.value = value;
+exports.attribute = attribute;
+class ValueOperand {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+    substitute(params) {
+        const { values } = params;
+        return values.reference(this.value).toString();
+    }
+}
+exports.ValueOperand = ValueOperand;
+function value(value) {
+    return new ValueOperand(value);
+}
+class AttributeOperand {
+    path;
+    constructor(path) {
+        this.path = path;
+    }
+    substitute(params) {
+        const { names } = params;
+        return names.substitute(this.path);
+    }
+}
+exports.AttributeOperand = AttributeOperand;
+function attribute(path) {
+    return new AttributeOperand(path);
+}
+//# sourceMappingURL=operands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"operands.js","sourceRoot":"","sources":["../../../../src/commands/expressions/operands.ts"],"names":[],"mappings":";;;AAgCA,sBAIC;AAkBD,8BAEC;AAxCD,MAAa,YAAY;IACN,KAAK,CAAI;IAE1B,YAAY,KAAQ;QAClB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,UAAU,CAAC,MAGV;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;QAC1B,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;IACjD,CAAC;CACF;AAdD,oCAcC;AAED,SAAgB,KAAK,CACnB,KAAqB;IAErB,OAAO,IAAI,YAAY,CAAC,KAAK,CAAC,CAAC;AACjC,CAAC;AAED,MAAa,gBAAgB;IACV,IAAI,CAAgB;IAErC,YAAY,IAAmB;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED,UAAU,CAAC,MAGV;QACC,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;QACzB,OAAO,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;CACF;AAdD,4CAcC;AAED,SAAgB,SAAS,CAAC,IAAmB;IAC3C,OAAO,IAAI,gBAAgB,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC"}