betterddb 0.8.0 → 0.8.2

package/dist/src/betterddb.d.ts

@@ -0,0 +1,137 @@
+import { type z } from "zod";
+import { QueryBuilder } from "./builders/query-builder.js";
+import { ScanBuilder } from "./builders/scan-builder.js";
+import { UpdateBuilder } from "./builders/update-builder.js";
+import { CreateBuilder } from "./builders/create-builder.js";
+import { GetBuilder } from "./builders/get-builder.js";
+import { DeleteBuilder } from "./builders/delete-builder.js";
+import { type NativeAttributeValue, type DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { BatchGetBuilder } from "./builders/batch-get-builder.js";
+export type PrimaryKeyValue = string | number;
+/**
+ * A key definition can be either a simple key (a property name)
+ * or an object containing a build function that computes the value.
+ * (In this design, the attribute name is provided separately.)
+ */
+export type KeyDefinition<T> = keyof T | {
+    build: (rawKey: Partial<T>) => string;
+};
+/**
+ * Configuration for a primary (partition) key.
+ */
+export interface PrimaryKeyConfig<T> {
+    /** The attribute name for the primary key in DynamoDB */
+    name: string;
+    /** How to compute the key value; if a keyof T, then the raw value is used;
+     * if an object, the build function is used.
+     */
+    definition: KeyDefinition<T>;
+}
+/**
+ * Configuration for a sort key.
+ */
+export interface SortKeyConfig<T> {
+    /** The attribute name for the sort key in DynamoDB */
+    name: string;
+    /** How to compute the sort key value */
+    definition: KeyDefinition<T>;
+}
+/**
+ * Configuration for a Global Secondary Index (GSI).
+ */
+export interface GSIConfig<T> {
+    /** The name of the GSI in DynamoDB */
+    name: string;
+    /** The primary key configuration for the GSI */
+    primary: PrimaryKeyConfig<T>;
+    /** The sort key configuration for the GSI, if any */
+    sort?: SortKeyConfig<T>;
+}
+/**
+ * Keys configuration for the table.
+ */
+export interface KeysConfig<T> {
+    primary: PrimaryKeyConfig<T>;
+    sort?: SortKeyConfig<T>;
+    gsis?: Record<string, GSIConfig<T>>;
+}
+/**
+ * Options for initializing BetterDDB.
+ */
+export interface BetterDDBOptions<T> {
+    schema: z.AnyZodObject;
+    tableName: string;
+    entityType?: string;
+    keys: KeysConfig<T>;
+    client: DynamoDBDocumentClient;
+    counter?: boolean;
+    /**
+     * If true, automatically inject timestamp fields:
+     * - On create, sets both `createdAt` and `updatedAt`
+     * - On update, sets `updatedAt`
+     *
+     * (T should include these fields if enabled.)
+     */
+    timestamps?: boolean;
+}
+/**
+ * BetterDDB is a definition-based DynamoDB wrapper library.
+ */
+export declare class BetterDDB<T> {
+    protected schema: z.AnyZodObject;
+    protected tableName: string;
+    protected entityType?: string;
+    protected client: DynamoDBDocumentClient;
+    protected keys: KeysConfig<T>;
+    protected timestamps: boolean;
+    protected counter: boolean;
+    constructor(options: BetterDDBOptions<T>);
+    getCounter(): boolean;
+    getKeys(): KeysConfig<T>;
+    getTableName(): string;
+    getClient(): DynamoDBDocumentClient;
+    getSchema(): z.AnyZodObject;
+    getTimestamps(): boolean;
+    getEntityType(): string | undefined;
+    protected getKeyValue(def: KeyDefinition<T>, rawKey: Partial<T>): string;
+    /**
+     * Build the primary key from a raw key object.
+     */
+    buildKey(rawKey: Partial<T>): Record<string, NativeAttributeValue>;
+    /**
+     * Build index attributes for each defined GSI.
+     */
+    buildIndexes(rawItem: Partial<T>): Record<string, NativeAttributeValue>;
+    /**
+     * Create an item:
+     * - Computes primary key and index attributes,
+     * - Optionally injects timestamps,
+     * - Validates the item and writes it to DynamoDB.
+     */
+    create(item: T): CreateBuilder<T>;
+    /**
+     * Get an item by its primary key.
+     */
+    get(rawKey: Partial<T>): GetBuilder<T>;
+    /**
+     * Get multiple items by their primary keys.
+     */
+    batchGet(rawKeys: Partial<T>[]): BatchGetBuilder<T>;
+    /**
+     * Update an item.
+     */
+    update(key: Partial<T>): UpdateBuilder<T>;
+    /**
+     * Delete an item.
+     */
+    delete(rawKey: Partial<T>): DeleteBuilder<T>;
+    /**
+     * Query items.
+     */
+    query(key: Partial<T>): QueryBuilder<T>;
+    /**
+     * Scan for items.
+     */
+    scan(): ScanBuilder<T>;
+}
+//# sourceMappingURL=betterddb.d.ts.map

package/dist/src/betterddb.d.ts.map

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

package/dist/src/betterddb.js

@@ -0,0 +1,165 @@
+import {} from "zod";
+import { QueryBuilder } from "./builders/query-builder.js";
+import { ScanBuilder } from "./builders/scan-builder.js";
+import { UpdateBuilder } from "./builders/update-builder.js";
+import { CreateBuilder } from "./builders/create-builder.js";
+import { GetBuilder } from "./builders/get-builder.js";
+import { DeleteBuilder } from "./builders/delete-builder.js";
+import {} from "@aws-sdk/lib-dynamodb";
+import { BatchGetBuilder } from "./builders/batch-get-builder.js";
+/**
+ * BetterDDB is a definition-based DynamoDB wrapper library.
+ */
+export class BetterDDB {
+    schema;
+    tableName;
+    entityType;
+    client;
+    keys;
+    timestamps;
+    counter;
+    constructor(options) {
+        this.schema = options.schema;
+        this.tableName = options.tableName;
+        this.entityType = options.entityType?.toUpperCase();
+        this.keys = options.keys;
+        this.client = options.client;
+        this.timestamps = options.timestamps ?? false;
+        this.counter = options.counter ?? false;
+    }
+    getCounter() {
+        return this.counter;
+    }
+    getKeys() {
+        return this.keys;
+    }
+    getTableName() {
+        return this.tableName;
+    }
+    getClient() {
+        return this.client;
+    }
+    getSchema() {
+        return this.schema;
+    }
+    getTimestamps() {
+        return this.timestamps;
+    }
+    getEntityType() {
+        return this.entityType;
+    }
+    // Helper: Retrieve the key value from a KeyDefinition.
+    getKeyValue(def, rawKey) {
+        if (typeof def === "string" ||
+            typeof def === "number" ||
+            typeof def === "symbol") {
+            return String(rawKey[def]);
+        }
+        else {
+            return def.build(rawKey);
+        }
+    }
+    /**
+     * Build the primary key from a raw key object.
+     */
+    buildKey(rawKey) {
+        const keyObj = {};
+        // For primary (partition) key:
+        const pkConfig = this.keys.primary;
+        keyObj[pkConfig.name] =
+            typeof pkConfig.definition === "string" ||
+                typeof pkConfig.definition === "number" ||
+                typeof pkConfig.definition === "symbol"
+                ? String(rawKey[pkConfig.definition])
+                : pkConfig.definition.build(rawKey);
+        // For sort key, if defined:
+        if (this.keys.sort) {
+            const skConfig = this.keys.sort;
+            keyObj[skConfig.name] =
+                typeof skConfig.definition === "string" ||
+                    typeof skConfig.definition === "number" ||
+                    typeof skConfig.definition === "symbol"
+                    ? String(rawKey[skConfig.definition])
+                    : skConfig.definition.build(rawKey);
+        }
+        return keyObj;
+    }
+    /**
+     * Build index attributes for each defined GSI.
+     */
+    buildIndexes(rawItem) {
+        const indexAttributes = {};
+        if (this.keys.gsis) {
+            for (const gsiName in this.keys.gsis) {
+                const gsiConfig = this.keys.gsis[gsiName];
+                if (!gsiConfig)
+                    continue;
+                // Compute primary index attribute.
+                const primaryConfig = gsiConfig.primary;
+                indexAttributes[primaryConfig.name] =
+                    typeof primaryConfig.definition === "string" ||
+                        typeof primaryConfig.definition === "number" ||
+                        typeof primaryConfig.definition === "symbol"
+                        ? String(rawItem[primaryConfig.definition])
+                        : primaryConfig.definition.build(rawItem);
+                // Compute sort index attribute if provided.
+                if (gsiConfig?.sort) {
+                    const sortConfig = gsiConfig.sort;
+                    indexAttributes[sortConfig.name] =
+                        typeof sortConfig.definition === "string" ||
+                            typeof sortConfig.definition === "number" ||
+                            typeof sortConfig.definition === "symbol"
+                            ? String(rawItem[sortConfig.definition])
+                            : sortConfig.definition.build(rawItem);
+                }
+            }
+        }
+        return indexAttributes;
+    }
+    /**
+     * Create an item:
+     * - Computes primary key and index attributes,
+     * - Optionally injects timestamps,
+     * - Validates the item and writes it to DynamoDB.
+     */
+    create(item) {
+        return new CreateBuilder(this, item);
+    }
+    /**
+     * Get an item by its primary key.
+     */
+    get(rawKey) {
+        return new GetBuilder(this, rawKey);
+    }
+    /**
+     * Get multiple items by their primary keys.
+     */
+    batchGet(rawKeys) {
+        return new BatchGetBuilder(this, rawKeys);
+    }
+    /**
+     * Update an item.
+     */
+    update(key) {
+        return new UpdateBuilder(this, key);
+    }
+    /**
+     * Delete an item.
+     */
+    delete(rawKey) {
+        return new DeleteBuilder(this, rawKey);
+    }
+    /**
+     * Query items.
+     */
+    query(key) {
+        return new QueryBuilder(this, key);
+    }
+    /**
+     * Scan for items.
+     */
+    scan() {
+        return new ScanBuilder(this);
+    }
+}
+//# sourceMappingURL=betterddb.js.map

package/dist/src/betterddb.js.map

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

package/dist/src/builders/batch-get-builder.d.ts

@@ -0,0 +1,16 @@
+import { type BetterDDB } from "../betterddb.js";
+export declare class BatchGetBuilder<T> {
+    private parent;
+    private keys;
+    /**
+     * @param parent - The BetterDDB instance for the table.
+     * @param keys - An array of partial keys for the items you wish to retrieve.
+     */
+    constructor(parent: BetterDDB<T>, keys: Partial<T>[]);
+    /**
+     * Executes the batch get operation.
+     * Returns an array of parsed items of type T.
+     */
+    execute(): Promise<T[]>;
+}
+//# sourceMappingURL=batch-get-builder.d.ts.map

package/dist/src/builders/batch-get-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-get-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/batch-get-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAIjD,qBAAa,eAAe,CAAC,CAAC;IAM1B,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IANd;;;OAGG;gBAEO,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE;IAG5B;;;OAGG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC;CAqCrC"}

package/dist/src/builders/batch-get-builder.js

@@ -0,0 +1,54 @@
+/* eslint-disable no-unused-vars */
+import {} from "../betterddb.js";
+import { BatchGetCommand } from "@aws-sdk/lib-dynamodb";
+import {} from "@aws-sdk/client-dynamodb";
+export class BatchGetBuilder {
+    parent;
+    keys;
+    /**
+     * @param parent - The BetterDDB instance for the table.
+     * @param keys - An array of partial keys for the items you wish to retrieve.
+     */
+    constructor(parent, keys) {
+        this.parent = parent;
+        this.keys = keys;
+    }
+    /**
+     * Executes the batch get operation.
+     * Returns an array of parsed items of type T.
+     */
+    async execute() {
+        if (this.keys.length === 0) {
+            return [];
+        }
+        const seen = new Set();
+        const deduplicatedKeys = this.keys.filter((key) => {
+            const keyString = JSON.stringify(key);
+            if (seen.has(keyString)) {
+                return false;
+            }
+            seen.add(keyString);
+            return true;
+        });
+        const tableName = this.parent.getTableName();
+        // Build an array of keys using the parent's key builder.
+        const keysArray = deduplicatedKeys.map((key) => this.parent.buildKey(key));
+        // Construct the BatchGet parameters.
+        const params = {
+            RequestItems: {
+                [tableName]: {
+                    Keys: keysArray,
+                },
+            },
+        };
+        const result = await this.parent
+            .getClient()
+            .send(new BatchGetCommand(params));
+        const responses = result.Responses ? result.Responses[tableName] : [];
+        if (!responses) {
+            return [];
+        }
+        return this.parent.getSchema().array().parse(responses);
+    }
+}
+//# sourceMappingURL=batch-get-builder.js.map

package/dist/src/builders/batch-get-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-get-builder.js","sourceRoot":"","sources":["../../../src/builders/batch-get-builder.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,OAAO,EAAkB,MAAM,iBAAiB,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAA0B,MAAM,0BAA0B,CAAC;AAElE,MAAM,OAAO,eAAe;IAMhB;IACA;IANV;;;OAGG;IACH,YACU,MAAoB,EACpB,IAAkB;QADlB,WAAM,GAAN,MAAM,CAAc;QACpB,SAAI,GAAJ,IAAI,CAAc;IACzB,CAAC;IAEJ;;;OAGG;IACI,KAAK,CAAC,OAAO;QAClB,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;QACvB,MAAM,gBAAgB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE;YAChD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;gBACxB,OAAO,KAAK,CAAC;YACf,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC,CAAC,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,CAAC;QAC7C,yDAAyD;QACzD,MAAM,SAAS,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;QAE3E,qCAAqC;QACrC,MAAM,MAAM,GAAsB;YAChC,YAAY,EAAE;gBACZ,CAAC,SAAS,CAAC,EAAE;oBACX,IAAI,EAAE,SAAS;iBAChB;aACF;SACF,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,MAAM;aAC7B,SAAS,EAAE;aACX,IAAI,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,SAAS,CAAQ,CAAC;IACjE,CAAC;CACF"}

package/dist/src/builders/create-builder.d.ts

@@ -0,0 +1,12 @@
+import { type TransactWriteItem } from "@aws-sdk/client-dynamodb";
+import { type BetterDDB } from "../betterddb.js";
+export declare class CreateBuilder<T> {
+    private parent;
+    private item;
+    private extraTransactItems;
+    constructor(parent: BetterDDB<T>, item: T);
+    execute(): Promise<T>;
+    transactWrite(ops: TransactWriteItem[] | TransactWriteItem): this;
+    toTransactPut(): TransactWriteItem;
+}
+//# sourceMappingURL=create-builder.d.ts.map

package/dist/src/builders/create-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/create-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAGL,KAAK,iBAAiB,EACvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,qBAAa,aAAa,CAAC,CAAC;IAIxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,IAAI;IAJd,OAAO,CAAC,kBAAkB,CAA2B;gBAG3C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,IAAI,EAAE,CAAC;IAGJ,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;IA+C3B,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,IAAI;IASjE,aAAa,IAAI,iBAAiB;CAwB1C"}

package/dist/src/builders/create-builder.js

@@ -0,0 +1,84 @@
+/* eslint-disable no-unused-vars */
+import {} from "@aws-sdk/client-dynamodb";
+import {} from "../betterddb.js";
+import { PutCommand, TransactWriteCommand } from "@aws-sdk/lib-dynamodb";
+export class CreateBuilder {
+    parent;
+    item;
+    extraTransactItems = [];
+    constructor(parent, item) {
+        this.parent = parent;
+        this.item = item;
+    }
+    async execute() {
+        const validated = this.parent.getSchema().parse(this.item);
+        if (this.extraTransactItems.length > 0) {
+            // Build our update transaction item.
+            const myTransactItem = this.toTransactPut();
+            // Combine with extra transaction items.
+            const allItems = [...this.extraTransactItems, myTransactItem];
+            await this.parent.getClient().send(new TransactWriteCommand({
+                TransactItems: allItems,
+            }));
+            // After transaction, retrieve the updated item.
+            const result = await this.parent.get(this.item).execute();
+            if (result === null) {
+                throw new Error("Item not found after transaction create");
+            }
+            return result;
+        }
+        else {
+            let finalItem = {
+                ...this.item,
+                entityType: this.parent.getEntityType(),
+            };
+            if (this.parent.getTimestamps()) {
+                const now = new Date().toISOString();
+                finalItem = { ...finalItem, createdAt: now, updatedAt: now };
+            }
+            // Compute and merge primary key.
+            const computedKeys = this.parent.buildKey(validated);
+            finalItem = { ...finalItem, ...computedKeys };
+            // Compute and merge index attributes.
+            const indexAttributes = this.parent.buildIndexes(validated);
+            finalItem = { ...finalItem, ...indexAttributes };
+            await this.parent.getClient().send(new PutCommand({
+                TableName: this.parent.getTableName(),
+                Item: finalItem,
+            }));
+            return validated;
+        }
+    }
+    transactWrite(ops) {
+        if (Array.isArray(ops)) {
+            this.extraTransactItems.push(...ops);
+        }
+        else {
+            this.extraTransactItems.push(ops);
+        }
+        return this;
+    }
+    toTransactPut() {
+        const validated = this.parent.getSchema().parse(this.item);
+        let finalItem = {
+            ...this.item,
+            entityType: this.parent.getEntityType(),
+        };
+        if (this.parent.getTimestamps()) {
+            const now = new Date().toISOString();
+            finalItem = { ...finalItem, createdAt: now, updatedAt: now };
+        }
+        // Compute and merge primary key.
+        const computedKeys = this.parent.buildKey(validated);
+        finalItem = { ...finalItem, ...computedKeys };
+        // Compute and merge index attributes.
+        const indexAttributes = this.parent.buildIndexes(validated);
+        finalItem = { ...finalItem, ...indexAttributes };
+        const putItem = {
+            TableName: this.parent.getTableName(),
+            Item: finalItem,
+        };
+        return { Put: putItem };
+    }
+}
+//# sourceMappingURL=create-builder.js.map

package/dist/src/builders/create-builder.js.map

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

package/dist/src/builders/delete-builder.d.ts

@@ -0,0 +1,18 @@
+import { type BetterDDB } from "../betterddb.js";
+import { type TransactWriteItem } from "@aws-sdk/client-dynamodb";
+import { type NativeAttributeValue } from "@aws-sdk/lib-dynamodb";
+export declare class DeleteBuilder<T> {
+    private parent;
+    private key;
+    private condition?;
+    private extraTransactItems;
+    constructor(parent: BetterDDB<T>, key: Partial<T>);
+    /**
+     * Specify a condition expression for the delete operation.
+     */
+    withCondition(expression: string, attributeValues: Record<string, NativeAttributeValue>): this;
+    execute(): Promise<void>;
+    transactWrite(ops: TransactWriteItem[] | TransactWriteItem): this;
+    toTransactDelete(): TransactWriteItem;
+}
+//# sourceMappingURL=delete-builder.d.ts.map

package/dist/src/builders/delete-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/delete-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACjD,OAAO,EACL,KAAK,iBAAiB,EAEvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,uBAAuB,CAAC;AAC/B,qBAAa,aAAa,CAAC,CAAC;IAOxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAPb,OAAO,CAAC,SAAS,CAAC,CAGhB;IACF,OAAO,CAAC,kBAAkB,CAA2B;gBAE3C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAGzB;;OAEG;IACI,aAAa,CAClB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,GACpD,IAAI;IAUM,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA6B9B,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,IAAI;IASjE,gBAAgB,IAAI,iBAAiB;CAW7C"}

package/dist/src/builders/delete-builder.js

@@ -0,0 +1,75 @@
+/* eslint-disable no-unused-vars */
+import {} from "../betterddb.js";
+import {} from "@aws-sdk/client-dynamodb";
+import { TransactWriteCommand, DeleteCommand, } from "@aws-sdk/lib-dynamodb";
+export class DeleteBuilder {
+    parent;
+    key;
+    condition;
+    extraTransactItems = [];
+    constructor(parent, key) {
+        this.parent = parent;
+        this.key = key;
+    }
+    /**
+     * Specify a condition expression for the delete operation.
+     */
+    withCondition(expression, attributeValues) {
+        if (this.condition) {
+            this.condition.expression += ` AND ${expression}`;
+            Object.assign(this.condition.attributeValues, attributeValues);
+        }
+        else {
+            this.condition = { expression, attributeValues };
+        }
+        return this;
+    }
+    async execute() {
+        if (this.extraTransactItems.length > 0) {
+            // Build our update transaction item.
+            const myTransactItem = this.toTransactDelete();
+            // Combine with extra transaction items.
+            const allItems = [...this.extraTransactItems, myTransactItem];
+            await this.parent.getClient().send(new TransactWriteCommand({
+                TransactItems: allItems,
+            }));
+            // After transaction, retrieve the updated item.
+            const result = await this.parent.get(this.key).execute();
+            if (result === null) {
+                throw new Error("Item not found after transaction delete");
+            }
+        }
+        else {
+            const params = {
+                TableName: this.parent.getTableName(),
+                Key: this.parent.buildKey(this.key),
+            };
+            if (this.condition) {
+                params.ConditionExpression = this.condition.expression;
+                params.ExpressionAttributeValues = this.condition.attributeValues;
+            }
+            await this.parent.getClient().send(new DeleteCommand(params));
+        }
+    }
+    transactWrite(ops) {
+        if (Array.isArray(ops)) {
+            this.extraTransactItems.push(...ops);
+        }
+        else {
+            this.extraTransactItems.push(ops);
+        }
+        return this;
+    }
+    toTransactDelete() {
+        const deleteItem = {
+            TableName: this.parent.getTableName(),
+            Key: this.parent.buildKey(this.key),
+        };
+        if (this.condition) {
+            deleteItem.ConditionExpression = this.condition.expression;
+            deleteItem.ExpressionAttributeValues = this.condition.attributeValues;
+        }
+        return { Delete: deleteItem };
+    }
+}
+//# sourceMappingURL=delete-builder.js.map

package/dist/src/builders/delete-builder.js.map

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

package/dist/src/builders/get-builder.d.ts

@@ -0,0 +1,18 @@
+import { type BetterDDB } from "../betterddb.js";
+import { type TransactGetItem } from "@aws-sdk/client-dynamodb";
+export declare class GetBuilder<T> {
+    private parent;
+    private key;
+    private projectionExpression?;
+    private expressionAttributeNames;
+    private extraTransactItems;
+    constructor(parent: BetterDDB<T>, key: Partial<T>);
+    /**
+     * Specify a projection by providing an array of attribute names.
+     */
+    withProjection(attributes: (keyof T)[]): this;
+    execute(): Promise<T | null>;
+    transactGet(ops: TransactGetItem[] | TransactGetItem): this;
+    toTransactGet(): TransactGetItem;
+}
+//# sourceMappingURL=get-builder.d.ts.map

package/dist/src/builders/get-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/get-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAClC,qBAAa,UAAU,CAAC,CAAC;IAKrB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IALb,OAAO,CAAC,oBAAoB,CAAC,CAAS;IACtC,OAAO,CAAC,wBAAwB,CAA8B;IAC9D,OAAO,CAAC,kBAAkB,CAAyB;gBAEzC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAGzB;;OAEG;IACI,cAAc,CAAC,UAAU,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IAUvC,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IA6BlC,WAAW,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,eAAe,GAAG,IAAI;IAS3D,aAAa,IAAI,eAAe;CAWxC"}