@kensio/yulin 0.44.0 → 0.45.0

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token-reader.js

@@ -0,0 +1,105 @@
+import { simDynamoDbExpressionError } from "./sim-dynamodb-expression-error.js";
+import { readSimDynamoDbSymbol } from "./sim-dynamodb-expression-symbols.js";
+/**
+ * An attribute name written into an expression: a letter or underscore, then
+ * letters, numbers and underscores. A name outside that has to be written as an
+ * ExpressionAttributeNames placeholder, on real DynamoDB as well as here.
+ */
+const namePattern = /^[A-Za-z_]\w*/;
+/**
+ * A placeholder, after its leading `#` or `:`.
+ */
+const placeholderPattern = /^\w+/;
+/**
+ * The whole part of a number, which is a list index in the expressions
+ * supported so far.
+ */
+const digitsPattern = /^\d+/;
+/**
+ * The fractional part of a number, read straight after the whole part.
+ *
+ * A fraction is read as one number rather than as a number, a dot and another
+ * number, so an index of `1.5` is refused as a fraction rather than as a
+ * syntax error somewhere after it.
+ */
+const fractionPattern = /^\.\d+/;
+/**
+ * Reads the one token an expression starts with.
+ *
+ * This knows what each kind of token looks like. Where the tokens are and what
+ * order they come in is not its business, so it takes whatever is left of an
+ * expression and answers with the first thing in it.
+ */
+export class SimDynamoDbExpressionTokenReader {
+    expressionName;
+    constructor(expressionName) {
+        this.expressionName = expressionName;
+    }
+    /**
+     * Read the token at the start of what is left of an expression.
+     */
+    read(remaining) {
+        return (this.name(remaining) ??
+            this.placeholder("namePlaceholder", "#", remaining) ??
+            this.placeholder("valuePlaceholder", ":", remaining) ??
+            this.number(remaining) ??
+            this.symbol(remaining));
+    }
+    /**
+     * Read an attribute name written into the expression itself.
+     */
+    name(remaining) {
+        const text = namePattern.exec(remaining)?.[0];
+        if (text === undefined) {
+            return undefined;
+        }
+        return { kind: "name", text };
+    }
+    /**
+     * Read a placeholder, which is its marker and the word after it.
+     *
+     * A marker with no word after it is refused here rather than read as a
+     * marker on its own, since a bare `#` names nothing.
+     */
+    placeholder(kind, marker, remaining) {
+        if (!remaining.startsWith(marker)) {
+            return undefined;
+        }
+        const named = remaining.slice(marker.length);
+        const word = placeholderPattern.exec(named)?.[0];
+        if (word === undefined) {
+            throw this.error(`syntax error; the placeholder marker '${marker}' names nothing`);
+        }
+        return { kind, text: `${marker}${word}` };
+    }
+    /**
+     * Read a number, which is its digits and the fraction after them if it has
+     * one.
+     */
+    number(remaining) {
+        const digits = digitsPattern.exec(remaining)?.[0];
+        if (digits === undefined) {
+            return undefined;
+        }
+        const after = remaining.slice(digits.length);
+        const fraction = fractionPattern.exec(after)?.[0] ?? "";
+        return { kind: "number", text: `${digits}${fraction}` };
+    }
+    /**
+     * Read a single character that means something on its own.
+     */
+    symbol(remaining) {
+        const text = readSimDynamoDbSymbol(remaining);
+        if (text === undefined) {
+            throw this.error(`syntax error; unexpected character '${remaining.slice(0, 1)}'`);
+        }
+        return { kind: "symbol", text };
+    }
+    /**
+     * Build the error the expression being read is refused with.
+     */
+    error(reason) {
+        return simDynamoDbExpressionError(this.expressionName, reason);
+    }
+}
+//# sourceMappingURL=sim-dynamodb-expression-token-reader.js.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token-reader.js.map

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

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token.d.ts

@@ -0,0 +1,19 @@
+/**
+ * What one piece of a DynamoDB expression is.
+ *
+ * A placeholder keeps its `#` or `:` in its text, so an error can name it the
+ * way the request wrote it.
+ */
+export type SimDynamoDbExpressionTokenKind = "name" | "namePlaceholder" | "valuePlaceholder" | "number" | "symbol";
+/**
+ * One piece of a DynamoDB expression.
+ *
+ * The position is where the token starts in the expression text, so a refusal
+ * can say where it went wrong rather than only what was wrong.
+ */
+export interface SimDynamoDbExpressionToken {
+    readonly kind: SimDynamoDbExpressionTokenKind;
+    readonly text: string;
+    readonly position: number;
+}
+//# sourceMappingURL=sim-dynamodb-expression-token.d.ts.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-expression-token.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-expression-token.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,MAAM,8BAA8B,GACxC,MAAM,GAAG,iBAAiB,GAAG,kBAAkB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAExE;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=sim-dynamodb-expression-token.js.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-expression-token.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-expression-token.ts"],"names":[],"mappings":""}

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.d.ts

@@ -0,0 +1,25 @@
+import type { SimDynamoDbExpressionToken } from "./sim-dynamodb-expression-token.js";
+interface SimDynamoDbExpressionTokeniserProperties {
+    readonly expressionName: string;
+}
+/**
+ * Reads a DynamoDB expression into the pieces it is made of.
+ *
+ * Every expression parameter DynamoDB has is written in the same lexical
+ * shapes, so they are read here once rather than once per expression kind.
+ * What the pieces are allowed to say is left to whatever parses them.
+ *
+ * This walks the expression and records where each token was found. What each
+ * kind of token looks like belongs to
+ * {@link SimDynamoDbExpressionTokenReader}.
+ */
+export declare class SimDynamoDbExpressionTokeniser {
+    private readonly reader;
+    constructor(properties: SimDynamoDbExpressionTokeniserProperties);
+    /**
+     * Read an expression into its tokens, skipping the whitespace between them.
+     */
+    tokenise(expression: string): readonly SimDynamoDbExpressionToken[];
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-expression-tokeniser.d.ts.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-expression-tokeniser.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAQrF,UAAU,wCAAwC;IAChD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,8BAA8B;IACzC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAE1D,YAAY,UAAU,EAAE,wCAAwC,EAI/D;IAED;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,0BAA0B,EAAE,CAmBlE;CACF"}

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.js

@@ -0,0 +1,43 @@
+import { SimDynamoDbExpressionTokenReader } from "./sim-dynamodb-expression-token-reader.js";
+/**
+ * The gap between two tokens, which means nothing on its own.
+ */
+const whitespacePattern = /^\s+/;
+/**
+ * Reads a DynamoDB expression into the pieces it is made of.
+ *
+ * Every expression parameter DynamoDB has is written in the same lexical
+ * shapes, so they are read here once rather than once per expression kind.
+ * What the pieces are allowed to say is left to whatever parses them.
+ *
+ * This walks the expression and records where each token was found. What each
+ * kind of token looks like belongs to
+ * {@link SimDynamoDbExpressionTokenReader}.
+ */
+export class SimDynamoDbExpressionTokeniser {
+    reader;
+    constructor(properties) {
+        this.reader = new SimDynamoDbExpressionTokenReader(properties.expressionName);
+    }
+    /**
+     * Read an expression into its tokens, skipping the whitespace between them.
+     */
+    tokenise(expression) {
+        const tokens = [];
+        let position = 0;
+        while (position < expression.length) {
+            const remaining = expression.slice(position);
+            const whitespace = whitespacePattern.exec(remaining)?.[0];
+            if (whitespace === undefined) {
+                const read = this.reader.read(remaining);
+                tokens.push({ ...read, position });
+                position += read.text.length;
+            }
+            else {
+                position += whitespace.length;
+            }
+        }
+        return tokens;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-expression-tokeniser.js.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-expression-tokeniser.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-expression-tokeniser.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gCAAgC,EAAE,MAAM,2CAA2C,CAAC;AAE7F;;GAEG;AACH,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAMjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,8BAA8B;IACxB,MAAM,CAAmC;IAE1D,YAAY,UAAoD;QAC9D,IAAI,CAAC,MAAM,GAAG,IAAI,gCAAgC,CAChD,UAAU,CAAC,cAAc,CAC1B,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,QAAQ,CAAC,UAAkB;QACzB,MAAM,MAAM,GAAiC,EAAE,CAAC;QAChD,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEjB,OAAO,QAAQ,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC7C,MAAM,UAAU,GAAG,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YAE1D,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;gBAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAEzC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;gBACnC,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YAC/B,CAAC;iBAAM,CAAC;gBACN,QAAQ,IAAI,UAAU,CAAC,MAAM,CAAC;YAChC,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokens.d.ts

@@ -0,0 +1,71 @@
+import type { SimDynamoDbExpressionToken } from "./sim-dynamodb-expression-token.js";
+interface SimDynamoDbExpressionTokensProperties {
+    readonly expressionName: string;
+    readonly tokens: readonly SimDynamoDbExpressionToken[];
+}
+/**
+ * A parser's place in the tokens of one expression.
+ *
+ * Every expression kind is parsed by reading forwards through its tokens, so
+ * how far along it is, and what happens when it runs out, live here rather than
+ * in each parser.
+ */
+export declare class SimDynamoDbExpressionTokens {
+    private readonly expressionName;
+    private readonly tokens;
+    private position;
+    constructor(properties: SimDynamoDbExpressionTokensProperties);
+    /**
+     * Read an expression into the tokens a parser walks.
+     *
+     * An expression with nothing in it is refused here rather than by each
+     * parser, since none of them has anything to read either way. The reason
+     * says what that expression kind would have been asking for.
+     */
+    static of(expressionName: string, expression: string, emptyReason: string): SimDynamoDbExpressionTokens;
+    /**
+     * Whether every token has been read.
+     */
+    get atEnd(): boolean;
+    /**
+     * The next token, without reading it.
+     *
+     * An offset looks further ahead, which is what tells a function call from a
+     * document path that happens to start with the same word.
+     */
+    peek(offset?: number): SimDynamoDbExpressionToken | undefined;
+    /**
+     * Read the next token, refusing an expression that has run out.
+     */
+    next(expected: string): SimDynamoDbExpressionToken;
+    /**
+     * Read the next token when it is a symbol, and leave it otherwise.
+     */
+    takeSymbol(text: string): boolean;
+    /**
+     * Read a symbol the expression has to carry here.
+     */
+    expectSymbol(text: string, reason: string): void;
+    /**
+     * Read the next token when it is a keyword, and leave it otherwise.
+     *
+     * A keyword arrives as a name, since that is what it looks like. DynamoDB
+     * reads AND, OR, NOT, BETWEEN and IN whatever case they are written in, so
+     * they are matched that way here.
+     */
+    takeKeyword(word: string): boolean;
+    /**
+     * Read a keyword the expression has to carry here.
+     */
+    expectKeyword(word: string): void;
+    /**
+     * Build the error this expression is refused with.
+     */
+    error(reason: string): Error;
+    /**
+     * Whether some text is a keyword, whatever case it was written in.
+     */
+    private isKeyword;
+}
+export {};
+//# sourceMappingURL=sim-dynamodb-expression-tokens.d.ts.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-expression-tokens.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-expression-tokens.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAGrF,UAAU,qCAAqC;IAC7C,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,0BAA0B,EAAE,CAAC;CACxD;AAED;;;;;;GAMG;AACH,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwC;IAC/D,OAAO,CAAC,QAAQ,CAAK;IAErB,YAAY,UAAU,EAAE,qCAAqC,EAG5D;IAED;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,CACP,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,2BAA2B,CAa7B;IAED;;OAEG;IACH,IAAI,KAAK,IAAI,OAAO,CAEnB;IAED;;;;;OAKG;IACH,IAAI,CAAC,MAAM,SAAI,GAAG,0BAA0B,GAAG,SAAS,CAEvD;IAED;;OAEG;IACH,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,0BAA0B,CAYjD;IAED;;OAEG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUhC;IAED;;OAEG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAI/C;IAED;;;;;;OAMG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAUjC;IAED;;OAEG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAOhC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAE3B;IAED;;OAEG;IACH,OAAO,CAAC,SAAS;CAGlB"}

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokens.js

@@ -0,0 +1,117 @@
+import { simDynamoDbExpressionError } from "./sim-dynamodb-expression-error.js";
+import { SimDynamoDbExpressionTokeniser } from "./sim-dynamodb-expression-tokeniser.js";
+/**
+ * A parser's place in the tokens of one expression.
+ *
+ * Every expression kind is parsed by reading forwards through its tokens, so
+ * how far along it is, and what happens when it runs out, live here rather than
+ * in each parser.
+ */
+export class SimDynamoDbExpressionTokens {
+    expressionName;
+    tokens;
+    position = 0;
+    constructor(properties) {
+        this.expressionName = properties.expressionName;
+        this.tokens = properties.tokens;
+    }
+    /**
+     * Read an expression into the tokens a parser walks.
+     *
+     * An expression with nothing in it is refused here rather than by each
+     * parser, since none of them has anything to read either way. The reason
+     * says what that expression kind would have been asking for.
+     */
+    static of(expressionName, expression, emptyReason) {
+        const read = new this({
+            expressionName,
+            tokens: new SimDynamoDbExpressionTokeniser({ expressionName }).tokenise(expression),
+        });
+        if (read.atEnd) {
+            throw simDynamoDbExpressionError(expressionName, emptyReason);
+        }
+        return read;
+    }
+    /**
+     * Whether every token has been read.
+     */
+    get atEnd() {
+        return this.position >= this.tokens.length;
+    }
+    /**
+     * The next token, without reading it.
+     *
+     * An offset looks further ahead, which is what tells a function call from a
+     * document path that happens to start with the same word.
+     */
+    peek(offset = 0) {
+        return this.tokens.at(this.position + offset);
+    }
+    /**
+     * Read the next token, refusing an expression that has run out.
+     */
+    next(expected) {
+        const upcoming = this.peek();
+        if (upcoming === undefined) {
+            throw this.error(`syntax error; ${expected} expected, but the expression ended`);
+        }
+        this.position += 1;
+        return upcoming;
+    }
+    /**
+     * Read the next token when it is a symbol, and leave it otherwise.
+     */
+    takeSymbol(text) {
+        const candidate = this.peek();
+        if (candidate?.kind !== "symbol" || candidate.text !== text) {
+            return false;
+        }
+        this.position += 1;
+        return true;
+    }
+    /**
+     * Read a symbol the expression has to carry here.
+     */
+    expectSymbol(text, reason) {
+        if (!this.takeSymbol(text)) {
+            throw this.error(reason);
+        }
+    }
+    /**
+     * Read the next token when it is a keyword, and leave it otherwise.
+     *
+     * A keyword arrives as a name, since that is what it looks like. DynamoDB
+     * reads AND, OR, NOT, BETWEEN and IN whatever case they are written in, so
+     * they are matched that way here.
+     */
+    takeKeyword(word) {
+        const candidate = this.peek();
+        if (candidate?.kind !== "name" || !this.isKeyword(candidate.text, word)) {
+            return false;
+        }
+        this.position += 1;
+        return true;
+    }
+    /**
+     * Read a keyword the expression has to carry here.
+     */
+    expectKeyword(word) {
+        if (!this.takeKeyword(word)) {
+            throw this.error(`syntax error; ${word} expected, but ` +
+                `'${this.peek()?.text ?? "the end of the expression"}' was given`);
+        }
+    }
+    /**
+     * Build the error this expression is refused with.
+     */
+    error(reason) {
+        return simDynamoDbExpressionError(this.expressionName, reason);
+    }
+    /**
+     * Whether some text is a keyword, whatever case it was written in.
+     */
+    isKeyword(text, word) {
+        return text.toUpperCase() === word;
+    }
+}
+//# sourceMappingURL=sim-dynamodb-expression-tokens.js.map

package/dist/service/dynamodb/expression/sim-dynamodb-expression-tokens.js.map

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

package/dist/service/dynamodb/expression/sim-dynamodb-item-snapshot.d.ts

@@ -0,0 +1,41 @@
+import type { SimDynamoDbItem } from "../item/sim-dynamodb-item.js";
+import type { SimDynamoDbValue } from "../item/sim-dynamodb-value.js";
+import type { SimDynamoDbDocumentPath } from "./sim-dynamodb-document-path.js";
+/**
+ * The item an expression is read against, as it stood when the request reached
+ * it.
+ *
+ * A conditional write is checked against whatever is stored under its key,
+ * which may be nothing at all. That is what makes `attribute_not_exists(id)`
+ * the way to insert only if absent: with no item there, every path resolves to
+ * nothing.
+ *
+ * An update expression reads the same snapshot. Every action reads it rather
+ * than the item being built, so `REMOVE a SET b = a` still finds `a`.
+ */
+export declare class SimDynamoDbItemSnapshot {
+    private readonly item;
+    constructor(item?: SimDynamoDbItem);
+    /**
+     * The value a document path points at, or nothing when the item does not
+     * have it.
+     *
+     * A path reaching into the wrong kind of value resolves to nothing rather
+     * than failing, the same way a projection passes over it: the item does not
+     * have what was asked for.
+     */
+    valueAt(path: SimDynamoDbDocumentPath): SimDynamoDbValue | undefined;
+    /**
+     * Follow one step of a path, from whatever the step before reached.
+     */
+    private step;
+    /**
+     * The item as a value, so the first step of a path is taken the same way as
+     * every step after it.
+     *
+     * An item is a map of attributes, so a path starting with a list index
+     * points at nothing rather than needing a rule of its own.
+     */
+    private asMap;
+}
+//# sourceMappingURL=sim-dynamodb-item-snapshot.d.ts.map

package/dist/service/dynamodb/expression/sim-dynamodb-item-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-item-snapshot.d.ts","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-item-snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EACV,uBAAuB,EAExB,MAAM,iCAAiC,CAAC;AAEzC;;;;;;;;;;;GAWG;AACH,qBAAa,uBAAuB;IAClC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA8B;IAEnD,YAAY,IAAI,CAAC,EAAE,eAAe,EAEjC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,IAAI,EAAE,uBAAuB,GAAG,gBAAgB,GAAG,SAAS,CAYnE;IAED;;OAEG;IACH,OAAO,CAAC,IAAI;IAeZ;;;;;;OAMG;IACH,OAAO,CAAC,KAAK;CAOd"}

package/dist/service/dynamodb/expression/sim-dynamodb-item-snapshot.js

@@ -0,0 +1,62 @@
+/**
+ * The item an expression is read against, as it stood when the request reached
+ * it.
+ *
+ * A conditional write is checked against whatever is stored under its key,
+ * which may be nothing at all. That is what makes `attribute_not_exists(id)`
+ * the way to insert only if absent: with no item there, every path resolves to
+ * nothing.
+ *
+ * An update expression reads the same snapshot. Every action reads it rather
+ * than the item being built, so `REMOVE a SET b = a` still finds `a`.
+ */
+export class SimDynamoDbItemSnapshot {
+    item;
+    constructor(item) {
+        this.item = item;
+    }
+    /**
+     * The value a document path points at, or nothing when the item does not
+     * have it.
+     *
+     * A path reaching into the wrong kind of value resolves to nothing rather
+     * than failing, the same way a projection passes over it: the item does not
+     * have what was asked for.
+     */
+    valueAt(path) {
+        let value = this.asMap();
+        for (const segment of path.segments) {
+            if (value === undefined) {
+                return undefined;
+            }
+            value = this.step(value, segment);
+        }
+        return value;
+    }
+    /**
+     * Follow one step of a path, from whatever the step before reached.
+     */
+    step(value, segment) {
+        if (segment.kind === "attribute" && value.kind === "M") {
+            return value.entries.get(segment.name);
+        }
+        if (segment.kind === "index" && value.kind === "L") {
+            return value.values.at(segment.index);
+        }
+        return undefined;
+    }
+    /**
+     * The item as a value, so the first step of a path is taken the same way as
+     * every step after it.
+     *
+     * An item is a map of attributes, so a path starting with a list index
+     * points at nothing rather than needing a rule of its own.
+     */
+    asMap() {
+        if (this.item === undefined) {
+            return undefined;
+        }
+        return { kind: "M", entries: this.item.entries() };
+    }
+}
+//# sourceMappingURL=sim-dynamodb-item-snapshot.js.map

package/dist/service/dynamodb/expression/sim-dynamodb-item-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-item-snapshot.js","sourceRoot":"","sources":["../../../../src/service/dynamodb/expression/sim-dynamodb-item-snapshot.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,uBAAuB;IACjB,IAAI,CAA8B;IAEnD,YAAY,IAAsB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;OAOG;IACH,OAAO,CAAC,IAA6B;QACnC,IAAI,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QAEzB,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACpC,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;gBACxB,OAAO,SAAS,CAAC;YACnB,CAAC;YAED,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACK,IAAI,CACV,KAAuB,EACvB,OAAuC;QAEvC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YACvD,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACzC,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;YACnD,OAAO,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;;;;OAMG;IACK,KAAK;QACX,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;IACrD,CAAC;CACF"}

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.d.ts

@@ -0,0 +1,19 @@
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+import { type SimDynamoDbSetPair, type SimDynamoDbSetValue } from "../../item/sim-dynamodb-set-members.js";
+import type { SimDynamoDbValue } from "../../item/sim-dynamodb-value.js";
+/**
+ * The stored value and the value being applied, as two sets of one kind.
+ *
+ * ADD and DELETE both work from what an attribute already holds, and both are
+ * refused the same way when the two do not go together.
+ */
+export declare function simDynamoDbAppliedSets(stored: SimDynamoDbValue, applied: SimDynamoDbSetValue, clause: string, path: string): SimDynamoDbSetPair;
+/**
+ * Refuse a value of a type the clause has no meaning for.
+ */
+export declare function simDynamoDbIncorrectOperand(clause: string, kind: string, text: string): SimDynamoDbValidationException;
+/**
+ * Refuse a value that does not go with what the attribute already holds.
+ */
+export declare function simDynamoDbStoredMismatch(clause: string, storedKind: string, appliedKind: string, path: string): SimDynamoDbValidationException;
+//# sourceMappingURL=sim-dynamodb-update-accumulate-values.d.ts.map

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-update-accumulate-values.d.ts","sourceRoot":"","sources":["../../../../../src/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EAEzB,MAAM,wCAAwC,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGzE;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,GACX,kBAAkB,CAQpB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,8BAA8B,CAKhC;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,GACX,8BAA8B,CAMhC"}

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.js

@@ -0,0 +1,41 @@
+import { SimDynamoDbValidationException } from "../../error/dynamodb.error.js";
+import { isSimDynamoDbSet, simDynamoDbMatchingSets, } from "../../item/sim-dynamodb-set-members.js";
+import { simDynamoDbUpdateError } from "./sim-dynamodb-update-refusal.js";
+/**
+ * The stored value and the value being applied, as two sets of one kind.
+ *
+ * ADD and DELETE both work from what an attribute already holds, and both are
+ * refused the same way when the two do not go together.
+ */
+export function simDynamoDbAppliedSets(stored, applied, clause, path) {
+    const pair = pairedSets(stored, applied);
+    if (pair === undefined) {
+        throw simDynamoDbStoredMismatch(clause, stored.kind, applied.kind, path);
+    }
+    return pair;
+}
+/**
+ * Refuse a value of a type the clause has no meaning for.
+ */
+export function simDynamoDbIncorrectOperand(clause, kind, text) {
+    return simDynamoDbUpdateError(`Incorrect operand type for operator or function; operator: ${clause}, ` +
+        `operand type: ${kind}, in '${text}'`);
+}
+/**
+ * Refuse a value that does not go with what the attribute already holds.
+ */
+export function simDynamoDbStoredMismatch(clause, storedKind, appliedKind, path) {
+    return new SimDynamoDbValidationException(`An operand in the update expression has an incorrect data type: ` +
+        `${clause} cannot apply a ${appliedKind} to the ${storedKind} stored ` +
+        `at '${path}'`);
+}
+/**
+ * The two values paired up, when the stored one is a set of the same kind.
+ */
+function pairedSets(stored, applied) {
+    if (!isSimDynamoDbSet(stored)) {
+        return undefined;
+    }
+    return simDynamoDbMatchingSets(stored, applied);
+}
+//# sourceMappingURL=sim-dynamodb-update-accumulate-values.js.map

package/dist/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sim-dynamodb-update-accumulate-values.js","sourceRoot":"","sources":["../../../../../src/service/dynamodb/expression/update/sim-dynamodb-update-accumulate-values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,+BAA+B,CAAC;AAC/E,OAAO,EACL,gBAAgB,EAGhB,uBAAuB,GACxB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAE1E;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAwB,EACxB,OAA4B,EAC5B,MAAc,EACd,IAAY;IAEZ,MAAM,IAAI,GAAG,UAAU,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEzC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,yBAAyB,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,MAAc,EACd,IAAY,EACZ,IAAY;IAEZ,OAAO,sBAAsB,CAC3B,8DAA8D,MAAM,IAAI;QACtE,iBAAiB,IAAI,SAAS,IAAI,GAAG,CACxC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAc,EACd,UAAkB,EAClB,WAAmB,EACnB,IAAY;IAEZ,OAAO,IAAI,8BAA8B,CACvC,kEAAkE;QAChE,GAAG,MAAM,mBAAmB,WAAW,WAAW,UAAU,UAAU;QACtE,OAAO,IAAI,GAAG,CACjB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,UAAU,CACjB,MAAwB,EACxB,OAA4B;IAE5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAClD,CAAC"}