dynamo-document-builder 0.6.0 → 0.7.0

package/dist/commands/table-batch-write.mjs

@@ -0,0 +1,117 @@
+import { __classPrivateFieldSet, __awaiter, __classPrivateFieldGet } from '../node_modules/tslib/tslib.es6.mjs';
+import { DocumentBuilderError } from '../errors.mjs';
+import { BatchWriteCommand } from '@aws-sdk/lib-dynamodb';
+import { BATCH_WRITE_VALIDATION_CONCURRENCY } from '../internal-constants.mjs';
+import pMap from 'p-map';
+
+var _TableBatchWrite_config;
+/**
+ * Table-level command to perform a batch write across multiple entity types.
+ *
+ * Unlike `BatchWrite` which operates on a single entity type, this command accepts
+ * write operations from multiple entities via `entity.prepare(new BatchWrite({ ... }))`
+ * and executes them in a single DynamoDB BatchWrite request.
+ *
+ * Unprocessed puts and deletes are returned per entity in a tuple matching the input order.
+ *
+ * @example
+ * ```typescript
+ * const { unprocessedPuts, unprocessedDeletes } = await table.send(new TableBatchWrite({
+ *   writes: [
+ *     userEntity.prepare(new BatchWrite({
+ *       items: [{ userId: 'u1', name: 'Alice' }],
+ *       deletes: [{ userId: 'u2', name: 'Bob' }],
+ *     })),
+ *     orderEntity.prepare(new BatchWrite({
+ *       items: [{ orderId: 'o1', status: 'pending', total: 99 }],
+ *     })),
+ *   ],
+ * }))
+ *
+ * const [userUnprocessedPuts, orderUnprocessedPuts] = unprocessedPuts
+ * const [userUnprocessedDeletes, orderUnprocessedDeletes] = unprocessedDeletes
+ * ```
+ */
+// biome-ignore lint/suspicious/noExplicitAny: writes span multiple heterogeneous entity schemas
+class TableBatchWrite {
+    constructor(config) {
+        _TableBatchWrite_config.set(this, void 0);
+        __classPrivateFieldSet(this, _TableBatchWrite_config, config, "f");
+    }
+    execute(table) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g;
+            for (const group of __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes) {
+                if (group.entity.table !== table) {
+                    throw new DocumentBuilderError(`Entity table "${group.entity.table.tableName}" does not match the executing table "${table.tableName}"`);
+                }
+            }
+            // Build all requests across all entity groups, preserving group index for unprocessed mapping
+            // biome-ignore lint/suspicious/noExplicitAny: heterogeneous group schemas require any
+            const allRequests = (yield pMap(__classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes, (group) => {
+                var _a, _b;
+                return group.buildRequests((_a = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").skipValidation) !== null && _a !== void 0 ? _a : false, (_b = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").abortController) === null || _b === void 0 ? void 0 : _b.signal);
+            }, {
+                concurrency: BATCH_WRITE_VALIDATION_CONCURRENCY,
+                signal: (_a = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+            })).flat();
+            const batchWrite = new BatchWriteCommand({
+                RequestItems: {
+                    [table.tableName]: allRequests,
+                },
+                ReturnConsumedCapacity: __classPrivateFieldGet(this, _TableBatchWrite_config, "f").returnConsumedCapacity,
+                ReturnItemCollectionMetrics: __classPrivateFieldGet(this, _TableBatchWrite_config, "f").returnItemCollectionMetrics,
+            });
+            const result = yield table.documentClient.send(batchWrite, {
+                abortSignal: (_b = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").abortController) === null || _b === void 0 ? void 0 : _b.signal,
+                requestTimeout: __classPrivateFieldGet(this, _TableBatchWrite_config, "f").timeoutMs,
+            });
+            const unprocessedItems = (_d = (_c = result.UnprocessedItems) === null || _c === void 0 ? void 0 : _c[table.tableName]) !== null && _d !== void 0 ? _d : [];
+            // Map unprocessed items back to their respective entity groups
+            const unprocessedPuts = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes.map(() => undefined);
+            const unprocessedDeletes = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes.map(() => undefined);
+            for (const unprocessedItem of unprocessedItems) {
+                if ((_e = unprocessedItem.PutRequest) === null || _e === void 0 ? void 0 : _e.Item) {
+                    const item = unprocessedItem.PutRequest.Item;
+                    for (let i = 0; i < __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes.length; i++) {
+                        // biome-ignore lint/suspicious/noExplicitAny: heterogeneous group schemas require any
+                        const group = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes[i];
+                        const matched = group.matchUnprocessedPut(item);
+                        if (matched !== undefined) {
+                            if (!unprocessedPuts[i])
+                                unprocessedPuts[i] = [];
+                            unprocessedPuts[i].push(matched);
+                            break;
+                        }
+                    }
+                }
+                else if ((_f = unprocessedItem.DeleteRequest) === null || _f === void 0 ? void 0 : _f.Key) {
+                    // biome-ignore lint/suspicious/noExplicitAny: DynamoDB SDK returns untyped key objects
+                    const key = unprocessedItem.DeleteRequest.Key;
+                    for (let i = 0; i < __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes.length; i++) {
+                        // biome-ignore lint/suspicious/noExplicitAny: heterogeneous group schemas require any
+                        const group = __classPrivateFieldGet(this, _TableBatchWrite_config, "f").writes[i];
+                        const matched = group.matchUnprocessedDelete(key);
+                        if (matched !== undefined) {
+                            if (!unprocessedDeletes[i])
+                                unprocessedDeletes[i] = [];
+                            unprocessedDeletes[i].push(matched);
+                            break;
+                        }
+                    }
+                }
+            }
+            return {
+                responseMetadata: result.$metadata,
+                consumedCapacity: (_g = result.ConsumedCapacity) === null || _g === void 0 ? void 0 : _g[0],
+                itemCollectionMetrics: result.ItemCollectionMetrics,
+                unprocessedPuts: unprocessedPuts,
+                unprocessedDeletes: unprocessedDeletes,
+            };
+        });
+    }
+}
+_TableBatchWrite_config = new WeakMap();
+
+export { TableBatchWrite };
+//# sourceMappingURL=table-batch-write.mjs.map

package/dist/commands/table-batch-write.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-batch-write.mjs","sources":["../../src/commands/table-batch-write.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/dist/commands/table-transact-get.cjs

@@ -0,0 +1,73 @@
+'use strict';
+
+var tslib_es6 = require('../node_modules/tslib/tslib.es6.cjs');
+var errors = require('../errors.cjs');
+var libDynamodb = require('@aws-sdk/lib-dynamodb');
+
+var _TableTransactGet_config;
+/**
+ * Table-level command to perform a transactional read across multiple entity types.
+ *
+ * Unlike `TransactGet` which operates on a single entity type, this command accepts
+ * get operations from multiple entities via `entity.prepare(new TransactGet({ keys: [...] }))`
+ * and returns results grouped by entity in a tuple structure.
+ *
+ * @example
+ * ```typescript
+ * const { items } = await table.send(new TableTransactGet({
+ *   gets: [
+ *     userEntity.prepare(new TransactGet({ keys: [{ userId: 'u1' }] })),
+ *     orderEntity.prepare(new TransactGet({ keys: [{ orderId: 'o1' }, { orderId: 'o2' }] })),
+ *   ],
+ * }))
+ *
+ * const [users, orders] = items
+ * // users: (User | undefined)[]
+ * // orders: (Order | undefined)[]
+ * ```
+ */
+class TableTransactGet {
+    constructor(config) {
+        _TableTransactGet_config.set(this, void 0);
+        tslib_es6.__classPrivateFieldSet(this, _TableTransactGet_config, config, "f");
+    }
+    execute(table) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            for (const group of tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").gets) {
+                if (group.entity.table !== table) {
+                    throw new errors.DocumentBuilderError(`Entity table "${group.entity.table.tableName}" does not match the executing table "${table.tableName}"`);
+                }
+            }
+            const transactItems = tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").gets.flatMap(group => group.keys.map(key => ({ Get: key })));
+            const transactGet = new libDynamodb.TransactGetCommand({
+                TransactItems: transactItems,
+                ReturnConsumedCapacity: tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").returnConsumedCapacity,
+            });
+            const result = yield table.documentClient.send(transactGet, {
+                abortSignal: (_a = tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+                requestTimeout: tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").timeoutMs,
+            });
+            const rawResponses = (_b = result.Responses) !== null && _b !== void 0 ? _b : [];
+            // Split raw responses back into per-entity groups and parse each group
+            let offset = 0;
+            const groupedItems = [];
+            for (const group of tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").gets) {
+                const count = group.keys.length;
+                const slice = rawResponses.slice(offset, offset + count).map(r => r.Item);
+                const parsed = yield group.parseResults(slice, (_c = tslib_es6.__classPrivateFieldGet(this, _TableTransactGet_config, "f").skipValidation) !== null && _c !== void 0 ? _c : false);
+                groupedItems.push(parsed);
+                offset += count;
+            }
+            return {
+                items: groupedItems,
+                responseMetadata: result.$metadata,
+                consumedCapacity: (_d = result.ConsumedCapacity) === null || _d === void 0 ? void 0 : _d[0],
+            };
+        });
+    }
+}
+_TableTransactGet_config = new WeakMap();
+
+exports.TableTransactGet = TableTransactGet;
+//# sourceMappingURL=table-transact-get.cjs.map

package/dist/commands/table-transact-get.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-transact-get.cjs","sources":["../../src/commands/table-transact-get.ts"],"sourcesContent":[null],"names":["__classPrivateFieldSet","__classPrivateFieldGet","DocumentBuilderError","TransactGetCommand"],"mappings":";;;;;;;AAwCA;;;;;;;;;;;;;;;;;;;;AAoBG;MACU,gBAAgB,CAAA;AAK3B,IAAA,WAAA,CAAY,MAAoC,EAAA;QAFhD,wBAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAAA,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEa,IAAA,OAAO,CAAC,KAAkB,EAAA;;;YACrC,KAAK,MAAM,KAAK,IAAIC,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,IAAI,EAAE;gBACrC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE;AAChC,oBAAA,MAAM,IAAIC,2BAAoB,CAC5B,CAAA,cAAA,EAAiB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAA,sCAAA,EAAyC,KAAK,CAAC,SAAS,CAAA,CAAA,CAAG,CACzG;gBACH;YACF;AAEA,YAAA,MAAM,aAAa,GAAGD,gCAAA,CAAA,IAAI,gCAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE/F,YAAA,MAAM,WAAW,GAAG,IAAIE,8BAAkB,CAAC;AACzC,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAEF,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC5D,aAAA,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC1D,WAAW,EAAE,MAAAA,gCAAA,CAAA,IAAI,gCAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAEA,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,MAAM,YAAY,GAAG,CAAA,EAAA,GAAA,MAAM,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE;;YAG3C,IAAI,MAAM,GAAG,CAAC;YACd,MAAM,YAAY,GAA0B,EAAE;YAE9C,KAAK,MAAM,KAAK,IAAIA,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,IAAI,EAAE;AACrC,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM;gBAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AACzE,gBAAA,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA,EAAA,GAAAA,gCAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,cAAc,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK,CAAC;AACpF,gBAAA,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;gBACzB,MAAM,IAAI,KAAK;YACjB;YAEA,OAAO;AACL,gBAAA,KAAK,EAAE,YAA2C;gBAClD,gBAAgB,EAAE,MAAM,CAAC,SAAS;AAClC,gBAAA,gBAAgB,EAAE,CAAA,EAAA,GAAA,MAAM,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAG,CAAC,CAAC;aAC/C;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}

package/dist/commands/table-transact-get.d.ts

@@ -0,0 +1,60 @@
+import { PreparedGetTransaction, BaseConfig, BaseResult, TableCommand } from './index.js';
+import { DynamoTable } from '../core/table.js';
+import { EntitySchema } from '../core/index.js';
+import { ZodObject } from 'zod/v4';
+
+/**
+ * Extracts the result item type from a PreparedGetTransaction.
+ */
+type ExtractSchema<T> = T extends PreparedGetTransaction<infer S> ? EntitySchema<S> : never;
+/**
+ * Maps an array of PreparedGetTransactions to a tuple of their result item arrays.
+ */
+type TableTransactGetItems<Gets extends PreparedGetTransaction<ZodObject>[]> = {
+    [K in keyof Gets]: Array<ExtractSchema<Gets[K]> | undefined>;
+};
+/**
+ * Configuration for the TableTransactGet command.
+ *
+ * @template Gets - Tuple of PreparedGetTransaction types, one per entity group.
+ */
+type TableTransactGetConfig<Gets extends PreparedGetTransaction<ZodObject>[]> = BaseConfig & {
+    gets: [...Gets];
+};
+/**
+ * Result of the TableTransactGet command.
+ *
+ * @template Gets - Tuple of PreparedGetTransaction types, one per entity group.
+ */
+type TableTransactGetResult<Gets extends PreparedGetTransaction<ZodObject>[]> = BaseResult & {
+    items: TableTransactGetItems<Gets>;
+};
+/**
+ * Table-level command to perform a transactional read across multiple entity types.
+ *
+ * Unlike `TransactGet` which operates on a single entity type, this command accepts
+ * get operations from multiple entities via `entity.prepare(new TransactGet({ keys: [...] }))`
+ * and returns results grouped by entity in a tuple structure.
+ *
+ * @example
+ * ```typescript
+ * const { items } = await table.send(new TableTransactGet({
+ *   gets: [
+ *     userEntity.prepare(new TransactGet({ keys: [{ userId: 'u1' }] })),
+ *     orderEntity.prepare(new TransactGet({ keys: [{ orderId: 'o1' }, { orderId: 'o2' }] })),
+ *   ],
+ * }))
+ *
+ * const [users, orders] = items
+ * // users: (User | undefined)[]
+ * // orders: (Order | undefined)[]
+ * ```
+ */
+declare class TableTransactGet<Gets extends PreparedGetTransaction<ZodObject>[]> implements TableCommand<TableTransactGetResult<Gets>> {
+    #private;
+    constructor(config: TableTransactGetConfig<Gets>);
+    execute(table: DynamoTable): Promise<TableTransactGetResult<Gets>>;
+}
+
+export { TableTransactGet };
+export type { TableTransactGetConfig, TableTransactGetResult };

package/dist/commands/table-transact-get.mjs

@@ -0,0 +1,71 @@
+import { __classPrivateFieldSet, __awaiter, __classPrivateFieldGet } from '../node_modules/tslib/tslib.es6.mjs';
+import { DocumentBuilderError } from '../errors.mjs';
+import { TransactGetCommand } from '@aws-sdk/lib-dynamodb';
+
+var _TableTransactGet_config;
+/**
+ * Table-level command to perform a transactional read across multiple entity types.
+ *
+ * Unlike `TransactGet` which operates on a single entity type, this command accepts
+ * get operations from multiple entities via `entity.prepare(new TransactGet({ keys: [...] }))`
+ * and returns results grouped by entity in a tuple structure.
+ *
+ * @example
+ * ```typescript
+ * const { items } = await table.send(new TableTransactGet({
+ *   gets: [
+ *     userEntity.prepare(new TransactGet({ keys: [{ userId: 'u1' }] })),
+ *     orderEntity.prepare(new TransactGet({ keys: [{ orderId: 'o1' }, { orderId: 'o2' }] })),
+ *   ],
+ * }))
+ *
+ * const [users, orders] = items
+ * // users: (User | undefined)[]
+ * // orders: (Order | undefined)[]
+ * ```
+ */
+class TableTransactGet {
+    constructor(config) {
+        _TableTransactGet_config.set(this, void 0);
+        __classPrivateFieldSet(this, _TableTransactGet_config, config, "f");
+    }
+    execute(table) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d;
+            for (const group of __classPrivateFieldGet(this, _TableTransactGet_config, "f").gets) {
+                if (group.entity.table !== table) {
+                    throw new DocumentBuilderError(`Entity table "${group.entity.table.tableName}" does not match the executing table "${table.tableName}"`);
+                }
+            }
+            const transactItems = __classPrivateFieldGet(this, _TableTransactGet_config, "f").gets.flatMap(group => group.keys.map(key => ({ Get: key })));
+            const transactGet = new TransactGetCommand({
+                TransactItems: transactItems,
+                ReturnConsumedCapacity: __classPrivateFieldGet(this, _TableTransactGet_config, "f").returnConsumedCapacity,
+            });
+            const result = yield table.documentClient.send(transactGet, {
+                abortSignal: (_a = __classPrivateFieldGet(this, _TableTransactGet_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+                requestTimeout: __classPrivateFieldGet(this, _TableTransactGet_config, "f").timeoutMs,
+            });
+            const rawResponses = (_b = result.Responses) !== null && _b !== void 0 ? _b : [];
+            // Split raw responses back into per-entity groups and parse each group
+            let offset = 0;
+            const groupedItems = [];
+            for (const group of __classPrivateFieldGet(this, _TableTransactGet_config, "f").gets) {
+                const count = group.keys.length;
+                const slice = rawResponses.slice(offset, offset + count).map(r => r.Item);
+                const parsed = yield group.parseResults(slice, (_c = __classPrivateFieldGet(this, _TableTransactGet_config, "f").skipValidation) !== null && _c !== void 0 ? _c : false);
+                groupedItems.push(parsed);
+                offset += count;
+            }
+            return {
+                items: groupedItems,
+                responseMetadata: result.$metadata,
+                consumedCapacity: (_d = result.ConsumedCapacity) === null || _d === void 0 ? void 0 : _d[0],
+            };
+        });
+    }
+}
+_TableTransactGet_config = new WeakMap();
+
+export { TableTransactGet };
+//# sourceMappingURL=table-transact-get.mjs.map

package/dist/commands/table-transact-get.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-transact-get.mjs","sources":["../../src/commands/table-transact-get.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;AAwCA;;;;;;;;;;;;;;;;;;;;AAoBG;MACU,gBAAgB,CAAA;AAK3B,IAAA,WAAA,CAAY,MAAoC,EAAA;QAFhD,wBAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAA,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEa,IAAA,OAAO,CAAC,KAAkB,EAAA;;;YACrC,KAAK,MAAM,KAAK,IAAI,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,IAAI,EAAE;gBACrC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE;AAChC,oBAAA,MAAM,IAAI,oBAAoB,CAC5B,CAAA,cAAA,EAAiB,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAA,sCAAA,EAAyC,KAAK,CAAC,SAAS,CAAA,CAAA,CAAG,CACzG;gBACH;YACF;AAEA,YAAA,MAAM,aAAa,GAAG,sBAAA,CAAA,IAAI,gCAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;AAE/F,YAAA,MAAM,WAAW,GAAG,IAAI,kBAAkB,CAAC;AACzC,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAE,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC5D,aAAA,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC1D,WAAW,EAAE,MAAA,sBAAA,CAAA,IAAI,gCAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAE,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,MAAM,YAAY,GAAG,CAAA,EAAA,GAAA,MAAM,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE;;YAG3C,IAAI,MAAM,GAAG,CAAC;YACd,MAAM,YAAY,GAA0B,EAAE;YAE9C,KAAK,MAAM,KAAK,IAAI,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,IAAI,EAAE;AACrC,gBAAA,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,MAAM;gBAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC;AACzE,gBAAA,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,CAAA,EAAA,GAAA,sBAAA,CAAA,IAAI,EAAA,wBAAA,EAAA,GAAA,CAAQ,CAAC,cAAc,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,KAAK,CAAC;AACpF,gBAAA,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;gBACzB,MAAM,IAAI,KAAK;YACjB;YAEA,OAAO;AACL,gBAAA,KAAK,EAAE,YAA2C;gBAClD,gBAAgB,EAAE,MAAM,CAAC,SAAS;AAClC,gBAAA,gBAAgB,EAAE,CAAA,EAAA,GAAA,MAAM,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAG,CAAC,CAAC;aAC/C;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}

package/dist/commands/table-transact-write.cjs

@@ -0,0 +1,76 @@
+'use strict';
+
+var tslib_es6 = require('../node_modules/tslib/tslib.es6.cjs');
+var errors = require('../errors.cjs');
+var libDynamodb = require('@aws-sdk/lib-dynamodb');
+var internalConstants = require('../internal-constants.cjs');
+var pMap = require('p-map');
+
+var _TableTransactWrite_config;
+/**
+ * Table-level command to perform an atomic write transaction across multiple entity types.
+ *
+ * Unlike `TransactWrite` which operates on a single entity type, this command accepts
+ * operations from multiple entities via `entity.prepare([...])` and executes them as
+ * a single all-or-nothing DynamoDB transaction.
+ *
+ * @example
+ * ```typescript
+ * await table.send(new TableTransactWrite({
+ *   transactions: [
+ *     userEntity.prepare([
+ *       new Put({ item: { userId: 'u1', name: 'Alice' } }),
+ *       new Delete({ key: { userId: 'u2', name: 'Bob' } }),
+ *     ]),
+ *     orderEntity.prepare([
+ *       new Update({ key: { orderId: 'o1' }, update: { status: 'shipped' } }),
+ *     ]),
+ *   ],
+ * }))
+ * ```
+ */
+class TableTransactWrite {
+    constructor(config) {
+        _TableTransactWrite_config.set(this, void 0);
+        tslib_es6.__classPrivateFieldSet(this, _TableTransactWrite_config, config, "f");
+    }
+    execute(table) {
+        return tslib_es6.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            for (const { entity } of tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").transactions) {
+                if (entity.table !== table) {
+                    throw new errors.DocumentBuilderError(`Entity table "${entity.table.tableName}" does not match the executing table "${table.tableName}"`);
+                }
+            }
+            const transactItems = (yield pMap(tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").transactions, ({ entity, writes }) => {
+                var _a;
+                return pMap(writes, write => write.prepareWriteTransaction(entity), {
+                    concurrency: internalConstants.TRANSACTION_WRITE_VALIDATION_CONCURRENCY,
+                    signal: (_a = tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+                });
+            }, {
+                concurrency: internalConstants.TRANSACTION_WRITE_VALIDATION_CONCURRENCY,
+                signal: (_a = tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+            })).flat();
+            const writeTransaction = new libDynamodb.TransactWriteCommand({
+                TransactItems: transactItems,
+                ReturnConsumedCapacity: tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").returnConsumedCapacity,
+                ReturnItemCollectionMetrics: tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").returnItemCollectionMetrics,
+                ClientRequestToken: tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").idempotencyToken,
+            });
+            const result = yield table.documentClient.send(writeTransaction, {
+                abortSignal: (_b = tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _b === void 0 ? void 0 : _b.signal,
+                requestTimeout: tslib_es6.__classPrivateFieldGet(this, _TableTransactWrite_config, "f").timeoutMs,
+            });
+            return {
+                responseMetadata: result.$metadata,
+                consumedCapacity: result.ConsumedCapacity,
+                itemCollectionMetrics: result.ItemCollectionMetrics,
+            };
+        });
+    }
+}
+_TableTransactWrite_config = new WeakMap();
+
+exports.TableTransactWrite = TableTransactWrite;
+//# sourceMappingURL=table-transact-write.cjs.map

package/dist/commands/table-transact-write.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-transact-write.cjs","sources":["../../src/commands/table-transact-write.ts"],"sourcesContent":[null],"names":["__classPrivateFieldSet","__classPrivateFieldGet","DocumentBuilderError","TRANSACTION_WRITE_VALIDATION_CONCURRENCY","TransactWriteCommand"],"mappings":";;;;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;AAqBG;MACU,kBAAkB,CAAA;AAG7B,IAAA,WAAA,CAAY,MAAgC,EAAA;QAF5C,0BAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAAA,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEa,IAAA,OAAO,CAAC,KAAkB,EAAA;;;YACrC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAIC,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,YAAY,EAAE;AAClD,gBAAA,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE;AAC1B,oBAAA,MAAM,IAAIC,2BAAoB,CAC5B,CAAA,cAAA,EAAiB,MAAM,CAAC,KAAK,CAAC,SAAS,yCAAyC,KAAK,CAAC,SAAS,CAAA,CAAA,CAAG,CACnG;gBACH;YACF;AAEA,YAAA,MAAM,aAAa,GAAG,CACpB,MAAM,IAAI,CACRD,iCAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,YAAY,EACzB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAuC,KAAI;;AAC1D,gBAAA,OAAA,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE;AAC3D,oBAAA,WAAW,EAAEE,0DAAwC;oBACrD,MAAM,EAAE,MAAAF,gCAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,iBAAA,CAAC;aAAA,EACJ;AACE,gBAAA,WAAW,EAAEE,0DAAwC;gBACrD,MAAM,EAAE,MAAAF,gCAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,aAAA,CACF,EACD,IAAI,EAAE;AAER,YAAA,MAAM,gBAAgB,GAAG,IAAIG,gCAAoB,CAAC;AAChD,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAEH,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC3D,gBAAA,2BAA2B,EAAEA,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,2BAA2B;AACrE,gBAAA,kBAAkB,EAAEA,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,gBAAgB;AAClD,aAAA,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC/D,WAAW,EAAE,MAAAA,gCAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAEA,gCAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,OAAO;gBACL,gBAAgB,EAAE,MAAM,CAAC,SAAS;gBAClC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;aACpD;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}

package/dist/commands/table-transact-write.d.ts

@@ -0,0 +1,51 @@
+import { BaseConfig, PreparedWriteTransaction, TableCommand } from './index.js';
+import { DynamoTable } from '../core/table.js';
+import { ReturnItemCollectionMetrics, ConsumedCapacity, ItemCollectionMetrics } from '@aws-sdk/client-dynamodb';
+import { ResponseMetadata } from '@aws-sdk/types';
+
+/**
+ * Configuration for the TableTransactWrite command.
+ */
+type TableTransactWriteConfig = BaseConfig & {
+    transactions: PreparedWriteTransaction<any>[];
+    idempotencyToken?: string;
+    returnItemCollectionMetrics?: ReturnItemCollectionMetrics;
+};
+/**
+ * Result of the TableTransactWrite command.
+ */
+type TableTransactWriteResult = {
+    responseMetadata?: ResponseMetadata;
+    consumedCapacity?: ConsumedCapacity[] | undefined;
+    itemCollectionMetrics?: ItemCollectionMetrics;
+};
+/**
+ * Table-level command to perform an atomic write transaction across multiple entity types.
+ *
+ * Unlike `TransactWrite` which operates on a single entity type, this command accepts
+ * operations from multiple entities via `entity.prepare([...])` and executes them as
+ * a single all-or-nothing DynamoDB transaction.
+ *
+ * @example
+ * ```typescript
+ * await table.send(new TableTransactWrite({
+ *   transactions: [
+ *     userEntity.prepare([
+ *       new Put({ item: { userId: 'u1', name: 'Alice' } }),
+ *       new Delete({ key: { userId: 'u2', name: 'Bob' } }),
+ *     ]),
+ *     orderEntity.prepare([
+ *       new Update({ key: { orderId: 'o1' }, update: { status: 'shipped' } }),
+ *     ]),
+ *   ],
+ * }))
+ * ```
+ */
+declare class TableTransactWrite implements TableCommand<TableTransactWriteResult> {
+    #private;
+    constructor(config: TableTransactWriteConfig);
+    execute(table: DynamoTable): Promise<TableTransactWriteResult>;
+}
+
+export { TableTransactWrite };
+export type { TableTransactWriteConfig, TableTransactWriteResult };

package/dist/commands/table-transact-write.mjs

@@ -0,0 +1,74 @@
+import { __classPrivateFieldSet, __awaiter, __classPrivateFieldGet } from '../node_modules/tslib/tslib.es6.mjs';
+import { DocumentBuilderError } from '../errors.mjs';
+import { TransactWriteCommand } from '@aws-sdk/lib-dynamodb';
+import { TRANSACTION_WRITE_VALIDATION_CONCURRENCY } from '../internal-constants.mjs';
+import pMap from 'p-map';
+
+var _TableTransactWrite_config;
+/**
+ * Table-level command to perform an atomic write transaction across multiple entity types.
+ *
+ * Unlike `TransactWrite` which operates on a single entity type, this command accepts
+ * operations from multiple entities via `entity.prepare([...])` and executes them as
+ * a single all-or-nothing DynamoDB transaction.
+ *
+ * @example
+ * ```typescript
+ * await table.send(new TableTransactWrite({
+ *   transactions: [
+ *     userEntity.prepare([
+ *       new Put({ item: { userId: 'u1', name: 'Alice' } }),
+ *       new Delete({ key: { userId: 'u2', name: 'Bob' } }),
+ *     ]),
+ *     orderEntity.prepare([
+ *       new Update({ key: { orderId: 'o1' }, update: { status: 'shipped' } }),
+ *     ]),
+ *   ],
+ * }))
+ * ```
+ */
+class TableTransactWrite {
+    constructor(config) {
+        _TableTransactWrite_config.set(this, void 0);
+        __classPrivateFieldSet(this, _TableTransactWrite_config, config, "f");
+    }
+    execute(table) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b;
+            for (const { entity } of __classPrivateFieldGet(this, _TableTransactWrite_config, "f").transactions) {
+                if (entity.table !== table) {
+                    throw new DocumentBuilderError(`Entity table "${entity.table.tableName}" does not match the executing table "${table.tableName}"`);
+                }
+            }
+            const transactItems = (yield pMap(__classPrivateFieldGet(this, _TableTransactWrite_config, "f").transactions, ({ entity, writes }) => {
+                var _a;
+                return pMap(writes, write => write.prepareWriteTransaction(entity), {
+                    concurrency: TRANSACTION_WRITE_VALIDATION_CONCURRENCY,
+                    signal: (_a = __classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+                });
+            }, {
+                concurrency: TRANSACTION_WRITE_VALIDATION_CONCURRENCY,
+                signal: (_a = __classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _a === void 0 ? void 0 : _a.signal,
+            })).flat();
+            const writeTransaction = new TransactWriteCommand({
+                TransactItems: transactItems,
+                ReturnConsumedCapacity: __classPrivateFieldGet(this, _TableTransactWrite_config, "f").returnConsumedCapacity,
+                ReturnItemCollectionMetrics: __classPrivateFieldGet(this, _TableTransactWrite_config, "f").returnItemCollectionMetrics,
+                ClientRequestToken: __classPrivateFieldGet(this, _TableTransactWrite_config, "f").idempotencyToken,
+            });
+            const result = yield table.documentClient.send(writeTransaction, {
+                abortSignal: (_b = __classPrivateFieldGet(this, _TableTransactWrite_config, "f").abortController) === null || _b === void 0 ? void 0 : _b.signal,
+                requestTimeout: __classPrivateFieldGet(this, _TableTransactWrite_config, "f").timeoutMs,
+            });
+            return {
+                responseMetadata: result.$metadata,
+                consumedCapacity: result.ConsumedCapacity,
+                itemCollectionMetrics: result.ItemCollectionMetrics,
+            };
+        });
+    }
+}
+_TableTransactWrite_config = new WeakMap();
+
+export { TableTransactWrite };
+//# sourceMappingURL=table-transact-write.mjs.map

package/dist/commands/table-transact-write.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-transact-write.mjs","sources":["../../src/commands/table-transact-write.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;;;;AAkCA;;;;;;;;;;;;;;;;;;;;;AAqBG;MACU,kBAAkB,CAAA;AAG7B,IAAA,WAAA,CAAY,MAAgC,EAAA;QAF5C,0BAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAA,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEa,IAAA,OAAO,CAAC,KAAkB,EAAA;;;YACrC,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,YAAY,EAAE;AAClD,gBAAA,IAAI,MAAM,CAAC,KAAK,KAAK,KAAK,EAAE;AAC1B,oBAAA,MAAM,IAAI,oBAAoB,CAC5B,CAAA,cAAA,EAAiB,MAAM,CAAC,KAAK,CAAC,SAAS,yCAAyC,KAAK,CAAC,SAAS,CAAA,CAAA,CAAG,CACnG;gBACH;YACF;AAEA,YAAA,MAAM,aAAa,GAAG,CACpB,MAAM,IAAI,CACR,uBAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,YAAY,EACzB,CAAC,EAAE,MAAM,EAAE,MAAM,EAAuC,KAAI;;AAC1D,gBAAA,OAAA,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,KAAK,CAAC,uBAAuB,CAAC,MAAM,CAAC,EAAE;AAC3D,oBAAA,WAAW,EAAE,wCAAwC;oBACrD,MAAM,EAAE,MAAA,sBAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,iBAAA,CAAC;aAAA,EACJ;AACE,gBAAA,WAAW,EAAE,wCAAwC;gBACrD,MAAM,EAAE,MAAA,sBAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,aAAA,CACF,EACD,IAAI,EAAE;AAER,YAAA,MAAM,gBAAgB,GAAG,IAAI,oBAAoB,CAAC;AAChD,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAE,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC3D,gBAAA,2BAA2B,EAAE,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,2BAA2B;AACrE,gBAAA,kBAAkB,EAAE,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,gBAAgB;AAClD,aAAA,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE;gBAC/D,WAAW,EAAE,MAAA,sBAAA,CAAA,IAAI,kCAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAE,sBAAA,CAAA,IAAI,EAAA,0BAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,OAAO;gBACL,gBAAgB,EAAE,MAAM,CAAC,SAAS;gBAClC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;gBACzC,qBAAqB,EAAE,MAAM,CAAC,qBAAqB;aACpD;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}

package/dist/commands/transact-get.cjs

@@ -6,11 +6,49 @@ var internalConstants = require('../internal-constants.cjs');
 var pMap = require('p-map');
 
 var _TransactGet_config;
+/**
+ * Command to perform a transactional read of multiple items (all-or-nothing, strongly consistent).
+ *
+ * @template Schema - The Zod schema defining the structure of the entity.
+ *
+ * @example
+ * ```typescript
+ * import { DynamoTable, DynamoEntity, key, TransactGet } from 'dynamo-document-builder';
+ *
+ * const table = new DynamoTable({
+ *   tableName: 'ExampleTable',
+ *   documentClient,
+ * });
+ *
+ * const userEntity = new DynamoEntity({
+ *   table,
+ *   schema: z.object({
+ *     userId: z.string(),
+ *     name: z.string(),
+ *   }),
+ *   partitionKey: user => key('USER', user.userId),
+ *   sortKey: () => 'METADATA',
+ * });
+ *
+ * const transactGetCommand = new TransactGet({
+ *   keys: [
+ *     { userId: 'user1' },
+ *     { userId: 'user2' },
+ *   ],
+ * });
+ *
+ * const { items } = await userEntity.send(transactGetCommand);
+ * // items array has same order as keys, undefined if not found
+ * ```
+ */
 class TransactGet {
     constructor(config) {
         _TransactGet_config.set(this, void 0);
         tslib_es6.__classPrivateFieldSet(this, _TransactGet_config, config, "f");
     }
+    get keys() {
+        return tslib_es6.__classPrivateFieldGet(this, _TransactGet_config, "f").keys;
+    }
     execute(entity) {
         return tslib_es6.__awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d;

package/dist/commands/transact-get.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"transact-get.cjs","sources":["../../src/commands/transact-get.ts"],"sourcesContent":[null],"names":["__classPrivateFieldSet","__classPrivateFieldGet","TransactGetCommand","__awaiter","TRANSACTION_GET_VALIDATION_CONCURRENCY"],"mappings":";;;;;;;;MAgBa,WAAW,CAAA;AAKtB,IAAA,WAAA,CAAY,MAAiC,EAAA;QAF7C,mBAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAAA,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEa,IAAA,OAAO,CAAC,MAA4B,EAAA;;;AAC/C,YAAA,MAAM,aAAa,GAAGC,gCAAA,CAAA,IAAI,2BAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK;AAClD,gBAAA,GAAG,EAAE;AACH,oBAAA,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;AACjC,oBAAA,GAAG,EAAE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC;AACjC,iBAAA;AACF,aAAA,CAAC,CAAC;AAEH,YAAA,MAAM,WAAW,GAAG,IAAIC,8BAAkB,CAAC;AACzC,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAED,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC5D,aAAA,CAAC;AAEF,YAAA,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC5E,WAAW,EAAE,MAAAA,gCAAA,CAAA,IAAI,2BAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAEA,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,MAAM,QAAQ,GAAG,CAAA,EAAA,GAAA,iBAAiB,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE;YAClD,IAAI,KAAK,GAA4C,EAAE;AACvD,YAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,gBAAA,IAAIA,iCAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,cAAc,EAAE;AAC/B,oBAAA,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAwC,CAAC;gBACrF;qBAAO;oBACL,KAAK,GAAG,MAAM,IAAI,CAChB,QAAQ,EACR,CAAM,QAAQ,KAAGE,mBAAA,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAAA,aAAA;AACf,wBAAA,IAAI,QAAQ,CAAC,IAAI,EAAE;4BACjB,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAChD;AACA,wBAAA,OAAO,SAAS;AAClB,oBAAA,CAAC,CAAA,EACD;AACE,wBAAA,WAAW,EAAEC,wDAAsC;wBACnD,MAAM,EAAE,MAAAH,gCAAA,CAAA,IAAI,2BAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,qBAAA,CACF;gBACH;YACF;YAEA,OAAO;gBACL,KAAK;gBACL,gBAAgB,EAAE,iBAAiB,CAAC,SAAS;AAC7C,gBAAA,gBAAgB,EAAE,CAAA,EAAA,GAAA,iBAAiB,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAG,CAAC,CAAC;aAC1D;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}
+{"version":3,"file":"transact-get.cjs","sources":["../../src/commands/transact-get.ts"],"sourcesContent":[null],"names":["__classPrivateFieldSet","__classPrivateFieldGet","TransactGetCommand","__awaiter","TRANSACTION_GET_VALIDATION_CONCURRENCY"],"mappings":";;;;;;;;AA0BA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkCG;MACU,WAAW,CAAA;AAKtB,IAAA,WAAA,CAAY,MAAiC,EAAA;QAF7C,mBAAA,CAAA,GAAA,CAAA,IAAA,EAAA,MAAA,CAAA;AAGE,QAAAA,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAW,MAAM,EAAA,GAAA,CAAA;IACvB;AAEA,IAAA,IAAW,IAAI,GAAA;AACb,QAAA,OAAOC,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,IAAI;IAC1B;AAEa,IAAA,OAAO,CAAC,MAA4B,EAAA;;;AAC/C,YAAA,MAAM,aAAa,GAAGA,gCAAA,CAAA,IAAI,2BAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK;AAClD,gBAAA,GAAG,EAAE;AACH,oBAAA,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,SAAS;AACjC,oBAAA,GAAG,EAAE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC;AACjC,iBAAA;AACF,aAAA,CAAC,CAAC;AAEH,YAAA,MAAM,WAAW,GAAG,IAAIC,8BAAkB,CAAC;AACzC,gBAAA,aAAa,EAAE,aAAa;AAC5B,gBAAA,sBAAsB,EAAED,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,sBAAsB;AAC5D,aAAA,CAAC;AAEF,YAAA,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,EAAE;gBAC5E,WAAW,EAAE,MAAAA,gCAAA,CAAA,IAAI,2BAAQ,CAAC,eAAe,0CAAE,MAAM;AACjD,gBAAA,cAAc,EAAEA,gCAAA,CAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,SAAS;AACvC,aAAA,CAAC;YAEF,MAAM,QAAQ,GAAG,CAAA,EAAA,GAAA,iBAAiB,CAAC,SAAS,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,EAAA,GAAI,EAAE;YAClD,IAAI,KAAK,GAA4C,EAAE;AACvD,YAAA,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE;AACvB,gBAAA,IAAIA,iCAAA,IAAI,EAAA,mBAAA,EAAA,GAAA,CAAQ,CAAC,cAAc,EAAE;AAC/B,oBAAA,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,IAAI,QAAQ,CAAC,IAAwC,CAAC;gBACrF;qBAAO;oBACL,KAAK,GAAG,MAAM,IAAI,CAChB,QAAQ,EACR,CAAM,QAAQ,KAAGE,mBAAA,CAAA,IAAA,EAAA,MAAA,EAAA,MAAA,EAAA,aAAA;AACf,wBAAA,IAAI,QAAQ,CAAC,IAAI,EAAE;4BACjB,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC;wBAChD;AACA,wBAAA,OAAO,SAAS;AAClB,oBAAA,CAAC,CAAA,EACD;AACE,wBAAA,WAAW,EAAEC,wDAAsC;wBACnD,MAAM,EAAE,MAAAH,gCAAA,CAAA,IAAI,2BAAQ,CAAC,eAAe,0CAAE,MAAM;AAC7C,qBAAA,CACF;gBACH;YACF;YAEA,OAAO;gBACL,KAAK;gBACL,gBAAgB,EAAE,iBAAiB,CAAC,SAAS;AAC7C,gBAAA,gBAAgB,EAAE,CAAA,EAAA,GAAA,iBAAiB,CAAC,gBAAgB,MAAA,IAAA,IAAA,EAAA,KAAA,MAAA,GAAA,MAAA,GAAA,EAAA,CAAG,CAAC,CAAC;aAC1D;QACH,CAAC,CAAA;AAAA,IAAA;AACF;;;;;"}