effect-dynamodb 1.24.0 → 1.25.0

package/dist/internal/WriteDiagnosis.d.ts

@@ -0,0 +1,353 @@
+/**
+ * @internal Failure-time diagnosis of DynamoDB's rejections (#144).
+ *
+ * The library does not pre-check limits or request rules DynamoDB enforces
+ * itself — the 400 KB item, the 4 MB and 100-item transaction, the 2048-byte
+ * partition key and 1024-byte sort key, one operation per item, the limits on
+ * one expression, an `IN ()` with no operands, an empty key value, a reversed
+ * `BETWEEN`, a consistent read of a GSI, a table's vector index limits, a
+ * vector search's `TopK`. It sends the request; when DynamoDB rejects it, this
+ * module:
+ *
+ * 1. **recognises** the rejection by a stable fragment of its message (a
+ *    request-wide `ValidationException` or `LimitExceededException`, or a
+ *    `TransactionCanceledException` whose positional reason carries
+ *    `Code: "ValidationError"`);
+ * 2. **confirms** it against the request the site sent — an item count, a
+ *    key's UTF-8 bytes, an expression's length or operators, two entries
+ *    naming one item, an empty key value, the order of two bounds (each
+ *    confirmed only when the request breaks the rule), or, for item and
+ *    transaction sizes, by checking the request holds something the message
+ *    can apply to and measuring it exactly (`ItemSize.ts`);
+ * 3. **attributes** it to the culprit, using the targets the site built.
+ *
+ * A site turns the {@link Diagnosis} into its own tagged error with
+ * DynamoDB's error kept as the cause ({@link withCause}); anything
+ * unrecognised or unconfirmed passes through unchanged. Nothing is measured,
+ * and no target is built, unless DynamoDB has rejected the request.
+ *
+ * Every site goes through {@link diagnoseFailure}: writes ({@link SentWrite}),
+ * reads ({@link SentRead}), table management ({@link SentTable}) and vector
+ * searches ({@link SentSearch}) share the one recognise / confirm / rewrite
+ * path.
+ */
+import type { AttributeValue, TransactGetItem, TransactWriteItem, WriteRequest } from "@aws-sdk/client-dynamodb";
+import { ValidationError } from "@effect-dynamodb/schema/Errors.js";
+import { Effect } from "effect";
+/** DynamoDB's limit on a partition (hash) key value, in UTF-8 bytes. */
+export declare const PARTITION_KEY_MAX_BYTES = 2048;
+/** DynamoDB's limit on a sort (range) key value, in UTF-8 bytes. */
+export declare const SORT_KEY_MAX_BYTES = 1024;
+/**
+ * The key attributes a write can carry — its table's and its indexes' — by
+ * kind, so an over-long key value can be measured against its limit.
+ */
+export type KeyAttributes = {
+    readonly partition: ReadonlyArray<string>;
+    readonly sort: ReadonlyArray<string>;
+};
+/** The item a transact entry writes or checks, and how to name it in an error. */
+export type TransactItemTarget = {
+    /** Its table and primary key, as one comparable string. */
+    readonly identity: string;
+    /** The entity (or stream) it belongs to. */
+    readonly entityType: string;
+    /** What put it in the transaction: `operation 2 (User)`, `the event at version 4`. */
+    readonly source: string;
+    /** The key, readable: `pk=…, sk=…`. */
+    readonly key: string;
+};
+/**
+ * The target of a transact entry in `tableName`, keyed by `keyFields` (the
+ * table's primary key attributes): read from a Put's item, or any other
+ * entry's `Key` (a `TransactGetItems` entry's included).
+ */
+export declare const transactItemTarget: (item: TransactWriteItem | TransactGetItem, tableName: string, keyFields: ReadonlyArray<string>, entityType: string, source: string) => TransactItemTarget;
+/**
+ * What a writing site sent, as the diagnosis needs it. A single-item write is
+ * given in its transact-entry form (`{ Put }`, `{ Update }`, `{ Delete }`); a
+ * batch as its requests flattened to the same form ({@link batchEntries}).
+ * Targets are thunks: built only once DynamoDB has rejected the request.
+ *
+ * `callerCondition` is the caller's own `.condition()` on the entry at an
+ * index (the rest of its `ConditionExpression` is the library's guard), to
+ * say how much of an expression rejected for its size is the caller's.
+ */
+export type SentWrite = {
+    readonly _tag: "Item";
+    readonly item: TransactWriteItem;
+    readonly target: () => TransactItemTarget;
+    readonly callerCondition?: (() => string | undefined) | undefined;
+} | {
+    readonly _tag: "Transaction";
+    readonly items: ReadonlyArray<TransactWriteItem>;
+    readonly targets: () => ReadonlyArray<TransactItemTarget>;
+    readonly callerCondition?: ((index: number) => string | undefined) | undefined;
+} | {
+    readonly _tag: "Batch";
+    readonly items: ReadonlyArray<TransactWriteItem>;
+    readonly targets: () => ReadonlyArray<TransactItemTarget>;
+} | {
+    readonly _tag: "TransactGet";
+    readonly count: number;
+    /** The item each `Get` reads, to name a repeated one. */
+    readonly targets?: (() => ReadonlyArray<TransactItemTarget>) | undefined;
+} | {
+    /** A `BatchGetItem` request: the item each of its keys reads, in request order. */
+    readonly _tag: "BatchGet";
+    readonly targets: () => ReadonlyArray<TransactItemTarget>;
+};
+/** What a reading site sent: the `Query` / `Scan` request, as sent. */
+export type SentRead = {
+    readonly _tag: "Read";
+    readonly scan: boolean;
+    readonly input: {
+        readonly IndexName?: string | undefined;
+        readonly KeyConditionExpression?: string | undefined;
+        readonly FilterExpression?: string | undefined;
+        readonly ExpressionAttributeNames?: Record<string, string> | undefined;
+        readonly ExpressionAttributeValues?: Record<string, AttributeValue> | undefined;
+        readonly ConsistentRead?: boolean | undefined;
+    };
+};
+/** What a vector search sent: its `SearchVectors` request's `TopK`. */
+export type SentSearch = {
+    readonly _tag: "Search";
+    readonly index: string;
+    readonly topK: number;
+};
+/** A vector index as a `CreateTable` / `UpdateTable` request declares it. */
+export type SentVectorIndex = {
+    readonly IndexName?: string | undefined;
+    readonly Dimensions?: number | undefined;
+    readonly SearchSchema?: ReadonlyArray<{
+        readonly AttributeName?: string | undefined;
+        readonly SearchSchemaElementType?: string | undefined;
+    }> | undefined;
+};
+/** What a table-management site sent: the vector indexes of its request. */
+export type SentTable = {
+    readonly _tag: "Table";
+    readonly operation: "CreateTable" | "UpdateTable";
+    /** The vector indexes the request creates. */
+    readonly vectorIndexes: ReadonlyArray<SentVectorIndex>;
+    /** The entities sharing a physical vector index, to name them. */
+    readonly sharers: (indexName: string) => ReadonlyArray<string>;
+    /** How many vector indexes the table's entities declare in all. */
+    readonly declared: number;
+    /**
+     * `UpdateTable` only: how many vector indexes the table had when DynamoDB
+     * rejected the request, read back (`DescribeTable`) after the rejection.
+     * The request shows only the index it adds, so a count rejection is
+     * confirmed only when these plus the request's exceed the limit; unknown
+     * (the read failed) means unconfirmed.
+     */
+    readonly existing?: number | undefined;
+};
+/** Any request a site sent. */
+export type Sent = SentWrite | SentRead | SentTable | SentSearch;
+/** A confirmed reading of DynamoDB's rejection, naming the culprit. */
+export type Diagnosis = {
+    readonly _tag: "ItemTooLarge";
+    readonly target: TransactItemTarget;
+    /** The item's exact size (`itemBytes`), when the request carries the item. */
+    readonly bytes: number | undefined;
+    /** No item measures over the limit: this is the largest, named as the likely culprit. */
+    readonly likely: boolean;
+} | {
+    readonly _tag: "TooManyItems";
+    readonly count: number;
+    readonly limit: number;
+} | {
+    readonly _tag: "TransactionTooLarge";
+    /** DynamoDB's `Payload Size`, when its message carries one. */
+    readonly reported: number | undefined;
+    /**
+     * The request's exact size by the library's model (`transactItemBytes`
+     * summed). At or under the limit, the model disagrees with DynamoDB for
+     * this request — the error says so and gives both numbers.
+     */
+    readonly measured: number;
+    /** The largest contributors, largest first (at most three). */
+    readonly largest: ReadonlyArray<{
+        readonly target: TransactItemTarget;
+        readonly bytes: number;
+    }>;
+} | {
+    /** A key value over its limit: 2048 bytes for a partition key, 1024 for a sort key. */
+    readonly _tag: "KeyTooLong";
+    readonly target: TransactItemTarget;
+    readonly kind: "partition" | "sort";
+    readonly attribute: string;
+    readonly bytes: number;
+} | {
+    /** Two entries of one request target one item (DynamoDB allows one each). */
+    readonly _tag: "RepeatedItem";
+    readonly first: TransactItemTarget;
+    readonly second: TransactItemTarget;
+    /** The request was a `BatchWriteItem`, not a transaction. */
+    readonly batch: boolean;
+} | {
+    readonly _tag: "ExpressionTooLarge";
+    readonly target: TransactItemTarget;
+    readonly expression: "ConditionExpression" | "UpdateExpression";
+    readonly limit: "length" | "operators" | "inOperands";
+    /** The expression's length, operators, or largest `IN`, as DynamoDB counts them. */
+    readonly measured: number;
+    /** The caller's own `.condition()` within it, when the site knows it. */
+    readonly caller: {
+        readonly length: number;
+        readonly operators: number;
+        readonly inOperands: number;
+    } | undefined;
+} | {
+    /** A write puts an empty string (or binary) in a key attribute. */
+    readonly _tag: "EmptyKey";
+    readonly target: TransactItemTarget;
+    readonly attribute: string;
+    /** The secondary index whose key it is, as DynamoDB named it. */
+    readonly index: string | undefined;
+} | {
+    /**
+     * An `isIn()` with no values: its `IN ()`, which DynamoDB rejects as a
+     * syntax error, in a write's condition or a read's filter.
+     */
+    readonly _tag: "EmptyIn";
+    readonly expression: "ConditionExpression" | "FilterExpression";
+    /** The attribute (path) the `isIn()` tests. */
+    readonly attribute: string;
+    /** The write whose condition holds it; `undefined` for a read's filter. */
+    readonly target: TransactItemTarget | undefined;
+} | {
+    /** A query's key condition compares a key attribute with an empty value. */
+    readonly _tag: "EmptyKeyBound";
+    readonly attribute: string;
+    readonly index: string | undefined;
+} | {
+    /** A query's `BETWEEN` whose lower bound sorts after its upper bound. */
+    readonly _tag: "BetweenReversed";
+    readonly attribute: string;
+    readonly index: string | undefined;
+    readonly low: string;
+    readonly high: string;
+} | {
+    /** A consistent read of a GSI, which DynamoDB reads only eventually consistently. */
+    readonly _tag: "ConsistentReadOnGsi";
+    readonly index: string;
+    readonly scan: boolean;
+} | {
+    /** A vector index with more `INLINE_FILTER` attributes than DynamoDB allows. */
+    readonly _tag: "VectorIndexFilters";
+    readonly operation: "CreateTable" | "UpdateTable";
+    readonly index: string;
+    readonly filters: ReadonlyArray<string>;
+    readonly sharers: ReadonlyArray<string>;
+    readonly limit: number;
+} | {
+    /** A vector index whose dimensions are outside the range DynamoDB accepts. */
+    readonly _tag: "VectorIndexDimensions";
+    readonly operation: "CreateTable" | "UpdateTable";
+    readonly index: string;
+    readonly dimensions: number;
+    readonly sharers: ReadonlyArray<string>;
+} | {
+    /** A vector search's `TopK` outside the range DynamoDB accepts. */
+    readonly _tag: "TopKOutOfRange";
+    readonly index: string;
+    readonly topK: number;
+} | {
+    /** More vector indexes on one table than DynamoDB allows the account. */
+    readonly _tag: "VectorIndexCount";
+    readonly operation: "CreateTable" | "UpdateTable";
+    /** The vector indexes the request creates, with the entities sharing each. */
+    readonly indexes: ReadonlyArray<{
+        readonly index: string;
+        readonly sharers: ReadonlyArray<string>;
+    }>;
+    /** How many vector indexes the table's entities declare in all. */
+    readonly declared: number;
+    /** `UpdateTable`: how many vector indexes the table already had. */
+    readonly existing: number | undefined;
+    /** The limit DynamoDB stated, if its message carries one. */
+    readonly stated: number | undefined;
+};
+/** Whether `error` is a rejection this module could diagnose at all. */
+export declare const isDiagnosable: (error: unknown) => boolean;
+export declare const compareUtf8: (a: string, b: string) => number;
+/**
+ * Read DynamoDB's rejection of `sent`. `keys` names the key attributes a write
+ * writes (the table's and its indexes', by kind), for the key-size shape.
+ * `undefined`: unrecognised or unconfirmed — the site fails with `error`
+ * unchanged.
+ */
+export declare const diagnoseRejection: (error: unknown, sent: Sent, keys?: KeyAttributes) => Diagnosis | undefined;
+/** How a site describes what its operation had written before the rejected request. */
+export type ExplainOptions = {
+    /**
+     * What earlier requests of the operation are known to have written, as a
+     * clause: `"2 earlier transactions of versioned puts (200 items) were
+     * already written"`. A multi-request operation always says exactly what it
+     * wrote; never a vague "may have been written".
+     */
+    readonly committed?: string | undefined;
+};
+/**
+ * The explanation every site puts in its error, so the wording is identical
+ * library-wide. See {@link ExplainOptions} for a multi-request operation.
+ */
+export declare const explainDiagnosis: (diagnosis: Diagnosis, operation: string, options?: ExplainOptions) => string;
+/**
+ * An `Error` carrying `message`, with DynamoDB's error one step down as its
+ * own `cause` — what a diagnosed error stores in its `cause`, so the readable
+ * text stays where callers look and the original is kept.
+ */
+export declare const withCause: (message: string, original: unknown) => Error;
+/** The entity (or stream) a diagnosis names, for an error's `entityType`. */
+export declare const diagnosedEntityType: (diagnosis: Diagnosis, fallback: string) => string;
+/** The `ValidationError` a diagnosis becomes at most sites. */
+export declare const diagnosedValidationError: (diagnosis: Diagnosis, original: unknown, options: ExplainOptions & {
+    readonly operation: string;
+    readonly entityType: string;
+}) => ValidationError;
+/**
+ * Wrap a site's request so that, on failure only, a diagnosable error is read
+ * against what was sent and — when confirmed — rewritten by `rewrite`.
+ * Everything else, and every success, passes through untouched.
+ *
+ * Placed after the site's own conditional-failure mapping, so it only ever
+ * sees what that mapping could not explain — except for a repeated item: a
+ * site whose mapping reads conditional failures (and may retry them) wraps its
+ * request a second time, BEFORE that mapping, with `only: ["RepeatedItem"]`,
+ * because DynamoDB can report a repeat as a conditional failure that reads as
+ * a lost race. A diagnosis is terminal: no retry loop sees it.
+ *
+ * `only` limits the rewrite to those diagnoses; any other passes through.
+ */
+export declare const diagnoseFailure: <E2>(options: {
+    readonly sent: () => Sent;
+    readonly keys?: (() => KeyAttributes) | undefined;
+    readonly only?: ReadonlyArray<Diagnosis["_tag"]> | undefined;
+    readonly rewrite: (diagnosis: Diagnosis, original: unknown) => E2;
+}) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E | E2, R>;
+/**
+ * Targets for entries that all share one primary key schema (`keyFields`),
+ * named by `source(index, item)`. Each entry's own `TableName` is used.
+ */
+export declare const targetsFor: (items: ReadonlyArray<TransactWriteItem>, keyFields: ReadonlyArray<string>, entityType: string | ((index: number) => string), source: (index: number, item: TransactWriteItem) => string) => ReadonlyArray<TransactItemTarget>;
+/** A `BatchWriteItem` request map, flattened to transact-entry form in request order. */
+export declare const batchEntries: (requestItems: Record<string, ReadonlyArray<WriteRequest>>) => ReadonlyArray<TransactWriteItem>;
+/**
+ * The key attributes an entity writes, by kind: its primary key's and each
+ * index's partition and sort keys. `indexes` is an entity's `indexes` record.
+ */
+export declare const keyAttributesOf: (indexes: Readonly<Record<string, {
+    readonly pk?: {
+        readonly field: string;
+    } | undefined;
+    readonly sk?: {
+        readonly field: string;
+    } | undefined;
+}>>) => KeyAttributes;
+/** Key attributes from several sources, each attribute once per kind. */
+export declare const mergeKeyAttributes: (...all: ReadonlyArray<KeyAttributes>) => KeyAttributes;
+//# sourceMappingURL=WriteDiagnosis.d.ts.map

package/dist/internal/WriteDiagnosis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WriteDiagnosis.d.ts","sourceRoot":"","sources":["../../src/internal/WriteDiagnosis.ts"],"names":[],"mappings":"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"}