betterddb 0.6.0 → 0.6.4

package/lib/builders/update-builder.js

@@ -3,17 +3,22 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UpdateBuilder = void 0;
 const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
 class UpdateBuilder {
+    parent;
+    key;
+    actions = {};
+    condition;
+    // When using transaction mode, we store extra transaction items.
+    extraTransactItems = [];
     // Reference to the parent BetterDDB instance and key.
     constructor(parent, key) {
         this.parent = parent;
         this.key = key;
-        this.actions = {};
-        // When using transaction mode, we store extra transaction items.
-        this.extraTransactItems = [];
     }
     // Chainable methods:
     set(attrs) {
-        this.actions.set = { ...this.actions.set, ...attrs };
+        const partialSchema = this.parent.getSchema().partial();
+        const validated = partialSchema.parse(attrs);
+        this.actions.set = { ...this.actions.set, ...validated };
         return this;
     }
     remove(attrs) {
@@ -21,7 +26,9 @@ class UpdateBuilder {
         return this;
     }
     add(attrs) {
-        this.actions.add = { ...this.actions.add, ...attrs };
+        const partialSchema = this.parent.getSchema().partial();
+        const validated = partialSchema.parse(attrs);
+        this.actions.add = { ...this.actions.add, ...validated };
         return this;
     }
     delete(attrs) {
@@ -72,17 +79,17 @@ class UpdateBuilder {
                 setParts.push(`${nameKey} = ${valueKey}`);
             }
             if (setParts.length > 0) {
-                clauses.push(`SET ${setParts.join(', ')}`);
+                clauses.push(`SET ${setParts.join(", ")}`);
             }
         }
         // Build REMOVE clause.
         if (this.actions.remove && this.actions.remove.length > 0) {
-            const removeParts = this.actions.remove.map(attr => {
+            const removeParts = this.actions.remove.map((attr) => {
                 const nameKey = `#remove_${String(attr)}`;
                 ExpressionAttributeNames[nameKey] = String(attr);
                 return nameKey;
             });
-            clauses.push(`REMOVE ${removeParts.join(', ')}`);
+            clauses.push(`REMOVE ${removeParts.join(", ")}`);
         }
         // Build ADD clause.
         if (this.actions.add) {
@@ -95,7 +102,7 @@ class UpdateBuilder {
                 addParts.push(`${nameKey} ${valueKey}`);
             }
             if (addParts.length > 0) {
-                clauses.push(`ADD ${addParts.join(', ')}`);
+                clauses.push(`ADD ${addParts.join(", ")}`);
             }
         }
         // Build DELETE clause.
@@ -109,7 +116,7 @@ class UpdateBuilder {
                 deleteParts.push(`${nameKey} ${valueKey}`);
             }
             if (deleteParts.length > 0) {
-                clauses.push(`DELETE ${deleteParts.join(', ')}`);
+                clauses.push(`DELETE ${deleteParts.join(", ")}`);
             }
         }
         // Merge any provided condition attribute values.
@@ -117,9 +124,9 @@ class UpdateBuilder {
             Object.assign(ExpressionAttributeValues, this.condition.attributeValues);
         }
         return {
-            updateExpression: clauses.join(' '),
+            updateExpression: clauses.join(" "),
             attributeNames: ExpressionAttributeNames,
-            attributeValues: ExpressionAttributeValues
+            attributeValues: ExpressionAttributeValues,
         };
     }
     /**
@@ -132,7 +139,7 @@ class UpdateBuilder {
             Key: this.parent.buildKey(this.key),
             UpdateExpression: updateExpression,
             ExpressionAttributeNames: attributeNames,
-            ExpressionAttributeValues: attributeValues
+            ExpressionAttributeValues: attributeValues,
         };
         if (this.condition && this.condition.expression) {
             updateItem.ConditionExpression = this.condition.expression;
@@ -149,12 +156,12 @@ class UpdateBuilder {
             // Combine with extra transaction items.
             const allItems = [...this.extraTransactItems, myTransactItem];
             await this.parent.getClient().send(new lib_dynamodb_1.TransactWriteCommand({
-                TransactItems: allItems
+                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 update');
+                throw new Error("Item not found after transaction update");
             }
             return result;
         }
@@ -167,14 +174,16 @@ class UpdateBuilder {
                 UpdateExpression: updateExpression,
                 ExpressionAttributeNames: attributeNames,
                 ExpressionAttributeValues: attributeValues,
-                ReturnValues: 'ALL_NEW'
+                ReturnValues: "ALL_NEW",
             };
             if (this.condition && this.condition.expression) {
                 params.ConditionExpression = this.condition.expression;
             }
-            const result = await this.parent.getClient().send(new lib_dynamodb_1.UpdateCommand(params));
+            const result = await this.parent
+                .getClient()
+                .send(new lib_dynamodb_1.UpdateCommand(params));
             if (!result.Attributes) {
-                throw new Error('No attributes returned after update');
+                throw new Error("No attributes returned after update");
             }
             return this.parent.getSchema().parse(result.Attributes);
         }

package/lib/operator.js

@@ -3,29 +3,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.getOperatorExpression = void 0;
 function getOperatorExpression(operator, nameKey, valueKey, secondValueKey) {
     switch (operator) {
-        case '==':
+        case "==":
             return `${nameKey} = ${valueKey}`;
-        case '!=':
+        case "!=":
             return `${nameKey} <> ${valueKey}`;
-        case '<':
+        case "<":
             return `${nameKey} < ${valueKey}`;
-        case '<=':
+        case "<=":
             return `${nameKey} <= ${valueKey}`;
-        case '>':
+        case ">":
             return `${nameKey} > ${valueKey}`;
-        case '>=':
+        case ">=":
             return `${nameKey} >= ${valueKey}`;
-        case 'begins_with':
+        case "begins_with":
             return `begins_with(${nameKey}, ${valueKey})`;
-        case 'between':
+        case "between":
             if (!secondValueKey) {
                 throw new Error("The 'between' operator requires two value keys");
             }
             return `${nameKey} BETWEEN ${valueKey} AND ${secondValueKey}`;
-        case 'contains':
+        case "contains":
             return `contains(${nameKey}, ${valueKey})`;
         default:
-            throw new Error(`Unsupported operator: ${operator}`);
+            throw new Error("Unsupported operator");
     }
 }
 exports.getOperatorExpression = getOperatorExpression;

package/lib/{betterddb.d.ts → types/betterddb.d.ts}

@@ -1,12 +1,12 @@
-import { z } from 'zod';
-import { QueryBuilder } from './builders/query-builder';
-import { ScanBuilder } from './builders/scan-builder';
-import { UpdateBuilder } from './builders/update-builder';
-import { CreateBuilder } from './builders/create-builder';
-import { GetBuilder } from './builders/get-builder';
-import { DeleteBuilder } from './builders/delete-builder';
-import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
-import { BatchGetBuilder } from './builders/batch-get-builder';
+import { z } from "zod";
+import { QueryBuilder } from "./builders/query-builder";
+import { ScanBuilder } from "./builders/scan-builder";
+import { UpdateBuilder } from "./builders/update-builder";
+import { CreateBuilder } from "./builders/create-builder";
+import { GetBuilder } from "./builders/get-builder";
+import { DeleteBuilder } from "./builders/delete-builder";
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { BatchGetBuilder } from "./builders/batch-get-builder";
 export type PrimaryKeyValue = string | number;
 /**
  * A key definition can be either a simple key (a property name)
@@ -66,6 +66,7 @@ export interface BetterDDBOptions<T> {
     entityType?: string;
     keys: KeysConfig<T>;
     client: DynamoDBDocumentClient;
+    counter?: boolean;
     /**
      * If true, automatically inject timestamp fields:
      * - On create, sets both `createdAt` and `updatedAt`
@@ -85,7 +86,9 @@ export declare class BetterDDB<T> {
     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;
@@ -133,3 +136,4 @@ export declare class BetterDDB<T> {
      */
     scan(): ScanBuilder<T>;
 }
+//# sourceMappingURL=betterddb.d.ts.map

package/lib/types/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/lib/{builders → types/builders}/batch-get-builder.d.ts

@@ -1,4 +1,4 @@
-import { BetterDDB } from '../betterddb';
+import { BetterDDB } from "../betterddb";
 export declare class BatchGetBuilder<T> {
     private parent;
     private keys;
@@ -13,3 +13,4 @@ export declare class BatchGetBuilder<T> {
      */
     execute(): Promise<T[]>;
 }
+//# sourceMappingURL=batch-get-builder.d.ts.map

package/lib/types/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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzC,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/lib/{builders → types/builders}/create-builder.d.ts

@@ -1,5 +1,5 @@
-import { TransactWriteItem } from '@aws-sdk/client-dynamodb';
-import { BetterDDB } from '../betterddb';
+import { TransactWriteItem } from "@aws-sdk/client-dynamodb";
+import { BetterDDB } from "../betterddb";
 export declare class CreateBuilder<T> {
     private parent;
     private item;
@@ -9,3 +9,4 @@ export declare class CreateBuilder<T> {
     transactWrite(ops: TransactWriteItem[] | TransactWriteItem): this;
     toTransactPut(): TransactWriteItem;
 }
+//# sourceMappingURL=create-builder.d.ts.map

package/lib/types/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":"AAAA,OAAO,EAGL,iBAAiB,EAClB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGzC,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/lib/{builders → types/builders}/delete-builder.d.ts

@@ -1,5 +1,5 @@
-import { BetterDDB } from '../betterddb';
-import { TransactWriteItem } from '@aws-sdk/client-dynamodb';
+import { BetterDDB } from "../betterddb";
+import { TransactWriteItem } from "@aws-sdk/client-dynamodb";
 export declare class DeleteBuilder<T> {
     private parent;
     private key;
@@ -14,3 +14,4 @@ export declare class DeleteBuilder<T> {
     transactWrite(ops: TransactWriteItem[] | TransactWriteItem): this;
     toTransactDelete(): TransactWriteItem;
 }
+//# sourceMappingURL=delete-builder.d.ts.map

package/lib/types/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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAmB,MAAM,0BAA0B,CAAC;AAE9E,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,GAAG,CAAC,GACnC,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/lib/{builders → types/builders}/get-builder.d.ts

@@ -1,5 +1,5 @@
-import { BetterDDB } from '../betterddb';
-import { TransactGetItem } from '@aws-sdk/client-dynamodb';
+import { BetterDDB } from "../betterddb";
+import { TransactGetItem } from "@aws-sdk/client-dynamodb";
 export declare class GetBuilder<T> {
     private parent;
     private key;
@@ -15,3 +15,4 @@ export declare class GetBuilder<T> {
     transactGet(ops: TransactGetItem[] | TransactGetItem): this;
     toTransactGet(): TransactGetItem;
 }
+//# sourceMappingURL=get-builder.d.ts.map

package/lib/types/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":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,EAAgB,eAAe,EAAE,MAAM,0BAA0B,CAAC;AACzE,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"}

package/lib/{builders → types/builders}/query-builder.d.ts

@@ -1,6 +1,6 @@
-import { BetterDDB } from '../betterddb';
-import { Operator } from '../operator';
-import { PaginatedResult } from '../types/paginated-result';
+import { BetterDDB } from "../betterddb";
+import { Operator } from "../operator";
+import { PaginatedResult } from "../types/paginated-result";
 export declare class QueryBuilder<T> {
     private parent;
     private key;
@@ -25,3 +25,4 @@ export declare class QueryBuilder<T> {
      */
     execute(): Promise<PaginatedResult<T>>;
 }
+//# sourceMappingURL=query-builder.d.ts.map

package/lib/types/builders/query-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/query-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAa,MAAM,cAAc,CAAC;AACpD,OAAO,EAAyB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,qBAAa,YAAY,CAAC,CAAC;IAWvB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAXb,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,gBAAgB,CAAgB;IACxC,OAAO,CAAC,wBAAwB,CAA8B;IAC9D,OAAO,CAAC,yBAAyB,CAA2B;IAC5D,OAAO,CAAC,KAAK,CAAC,CAAe;IAC7B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAsB;IACtC,OAAO,CAAC,SAAS,CAAiB;gBAGxB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAUlB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAkBnC,aAAa,IAAI,IAAI;IAKrB,cAAc,IAAI,IAAI;IAKtB,KAAK,CACV,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAC5C,IAAI;IAqDA,MAAM,CACX,SAAS,EAAE,MAAM,CAAC,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GACvB,IAAI;IAsCA,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKpD;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CA6BpD"}

package/lib/{builders → types/builders}/scan-builder.d.ts

@@ -1,6 +1,6 @@
-import { BetterDDB } from '../betterddb';
-import { Operator } from '../operator';
-import { PaginatedResult } from '../types/paginated-result';
+import { BetterDDB } from "../betterddb";
+import { Operator } from "../operator";
+import { PaginatedResult } from "../types/paginated-result";
 export declare class ScanBuilder<T> {
     private parent;
     private filters;
@@ -17,3 +17,4 @@ export declare class ScanBuilder<T> {
      */
     execute(): Promise<PaginatedResult<T>>;
 }
+//# sourceMappingURL=scan-builder.d.ts.map

package/lib/types/builders/scan-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scan-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/scan-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAyB,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,qBAAa,WAAW,CAAC,CAAC;IAOZ,OAAO,CAAC,MAAM;IAN1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,wBAAwB,CAA8B;IAC9D,OAAO,CAAC,yBAAyB,CAA2B;IAC5D,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,OAAO,CAAC,CAAsB;gBAElB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAEjC,KAAK,CACV,SAAS,EAAE,MAAM,CAAC,EAClB,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,GACvB,IAAI;IA+BA,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAKjC,SAAS,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAKpD;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;CAwBpD"}

package/lib/{builders → types/builders}/update-builder.d.ts

@@ -1,5 +1,5 @@
-import { BetterDDB } from '../betterddb';
-import { TransactWriteItem } from '@aws-sdk/client-dynamodb';
+import { BetterDDB } from "../betterddb";
+import { TransactWriteItem } from "@aws-sdk/client-dynamodb";
 export declare class UpdateBuilder<T> {
     private parent;
     private key;
@@ -32,3 +32,4 @@ export declare class UpdateBuilder<T> {
      */
     execute(): Promise<T>;
 }
+//# sourceMappingURL=update-builder.d.ts.map

package/lib/types/builders/update-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/update-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,iBAAiB,EAGlB,MAAM,0BAA0B,CAAC;AASlC,qBAAa,aAAa,CAAC,CAAC;IAWxB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,GAAG;IAXb,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,SAAS,CAAC,CAGhB;IAEF,OAAO,CAAC,kBAAkB,CAA2B;gBAI3C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC;IAIlB,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAS5B,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,IAAI;IAKhC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;IAS7D,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI;IAK9D;;OAEG;IACI,YAAY,CACjB,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GACnC,IAAI;IAWP;;OAEG;IACI,aAAa,CAAC,GAAG,EAAE,iBAAiB,EAAE,GAAG,iBAAiB,GAAG,IAAI;IASxE;;OAEG;IACH,OAAO,CAAC,eAAe;IA4EvB;;OAEG;IACI,gBAAgB,IAAI,iBAAiB;IAgB5C;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,CAAC,CAAC;CAyCnC"}

package/lib/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./betterddb";
+//# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/lib/types/operator.d.ts

@@ -0,0 +1,3 @@
+export type Operator = "==" | "!=" | "<" | "<=" | ">" | ">=" | "begins_with" | "between" | "contains";
+export declare function getOperatorExpression(operator: Operator, nameKey: string, valueKey: string, secondValueKey?: string): string;
+//# sourceMappingURL=operator.d.ts.map

package/lib/types/operator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator.d.ts","sourceRoot":"","sources":["../../src/operator.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAChB,IAAI,GACJ,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,GAAG,GACH,IAAI,GACJ,aAAa,GACb,SAAS,GACT,UAAU,CAAC;AAEf,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,cAAc,CAAC,EAAE,MAAM,GACtB,MAAM,CA0BR"}

package/lib/types/{paginated-result.d.ts → types/paginated-result.d.ts}

@@ -2,3 +2,4 @@ export type PaginatedResult<T> = {
     items: T[];
     lastKey: Record<string, any> | undefined;
 };
+//# sourceMappingURL=paginated-result.d.ts.map

package/lib/types/types/paginated-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paginated-result.d.ts","sourceRoot":"","sources":["../../../src/types/paginated-result.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,SAAS,CAAC;CAC1C,CAAC"}

package/package.json

@@ -1,17 +1,21 @@
 {
   "name": "betterddb",
-  "version": "0.6.0",
+  "version": "0.6.4",
   "description": "A definition-based DynamoDB wrapper library that provides a schema-driven and fully typesafe DAL.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {
-    "build": "tsc",
     "prepublishOnly": "npm run build",
     "docker:up": "docker-compose up -d",
     "docker:down": "docker-compose down",
     "test": "npm run docker:up && jest && npm run docker:down",
     "test:watch": "npm run docker:up && jest --watch",
-    "test:coverage": "npm run docker:up && jest --coverage && npm run docker:down"
+    "test:coverage": "npm run docker:up && jest --coverage && npm run docker:down",
+    "format": "prettier --write 'src/**/*.ts'",
+    "lint": "eslint src/**/*.ts",
+    "clean": "del-cli ./lib",
+    "build": "npm run clean && tsc -p ./tsconfig.json",
+    "prepack": "npm run build"
   },
   "keywords": [
     "dynamodb",
@@ -28,14 +32,20 @@
   "author": "R.R. Wang",
   "license": "MIT",
   "dependencies": {
-    "@aws-sdk/lib-dynamodb": "^3.744.0",
     "@aws-sdk/client-dynamodb": "^3.744.0",
+    "@aws-sdk/lib-dynamodb": "^3.744.0",
     "zod": "^3.24.1"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",
-    "@types/node": "^18.15.0",
+    "@types/node": "^22.13.5",
+    "@typescript-eslint/eslint-plugin": "^8.24.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
     "jest": "^29.7.0",
+    "prettier": "^3.3.3",
     "ts-jest": "^29.2.5",
     "typescript": "^4.9.5"
   }

package/prettier.config.js

@@ -0,0 +1,6 @@
+/** @type {import('prettier').Config} */
+const config = {
+  tabWidth: 2,
+};
+
+export default config;

package/src/betterddb.ts

@@ -1,13 +1,12 @@
-import { z } from 'zod';
-import { QueryBuilder } from './builders/query-builder';
-import { ScanBuilder } from './builders/scan-builder';
-import { UpdateBuilder } from './builders/update-builder';
-import { CreateBuilder } from './builders/create-builder';
-import { GetBuilder } from './builders/get-builder';
-import { DeleteBuilder } from './builders/delete-builder';
-import { DynamoDBDocumentClient } from '@aws-sdk/lib-dynamodb';
-import { BatchGetBuilder } from './builders/batch-get-builder';
-
+import { z } from "zod";
+import { QueryBuilder } from "./builders/query-builder";
+import { ScanBuilder } from "./builders/scan-builder";
+import { UpdateBuilder } from "./builders/update-builder";
+import { CreateBuilder } from "./builders/create-builder";
+import { GetBuilder } from "./builders/get-builder";
+import { DeleteBuilder } from "./builders/delete-builder";
+import { DynamoDBDocumentClient } from "@aws-sdk/lib-dynamodb";
+import { BatchGetBuilder } from "./builders/batch-get-builder";
 export type PrimaryKeyValue = string | number;
 
 /**
@@ -75,6 +74,7 @@ export interface BetterDDBOptions<T> {
   entityType?: string;
   keys: KeysConfig<T>;
   client: DynamoDBDocumentClient;
+  counter?: boolean;
   /**
    * If true, automatically inject timestamp fields:
    * - On create, sets both `createdAt` and `updatedAt`
@@ -95,6 +95,7 @@ export class BetterDDB<T> {
   protected client: DynamoDBDocumentClient;
   protected keys: KeysConfig<T>;
   protected timestamps: boolean;
+  protected counter: boolean;
 
   constructor(options: BetterDDBOptions<T>) {
     this.schema = options.schema;
@@ -103,21 +104,25 @@ export class BetterDDB<T> {
     this.keys = options.keys;
     this.client = options.client;
     this.timestamps = options.timestamps ?? false;
+    this.counter = options.counter ?? false;
+  }
+
+  public getCounter(): boolean {
+    return this.counter;
   }
 
   public getKeys(): KeysConfig<T> {
     return this.keys;
   }
-  
+
   public getTableName(): string {
     return this.tableName;
   }
-  
+
   public getClient(): DynamoDBDocumentClient {
     return this.client;
   }
-  
-  
+
   public getSchema(): z.ZodType<T, z.ZodTypeDef, any> {
     return this.schema;
   }
@@ -132,7 +137,11 @@ export class BetterDDB<T> {
 
   // Helper: Retrieve the key value from a KeyDefinition.
   protected getKeyValue(def: KeyDefinition<T>, rawKey: Partial<T>): string {
-    if (typeof def === 'string' || typeof def === 'number' || typeof def === 'symbol') {
+    if (
+      typeof def === "string" ||
+      typeof def === "number" ||
+      typeof def === "symbol"
+    ) {
       return String(rawKey[def]);
     } else {
       return def.build(rawKey);
@@ -144,29 +153,29 @@ export class BetterDDB<T> {
    */
   public buildKey(rawKey: Partial<T>): Record<string, any> {
     const keyObj: Record<string, any> = {};
-  
+
     // For primary (partition) key:
     const pkConfig = this.keys.primary;
     keyObj[pkConfig.name] =
-      (typeof pkConfig.definition === 'string' ||
-       typeof pkConfig.definition === 'number' ||
-       typeof pkConfig.definition === 'symbol')
+      typeof pkConfig.definition === "string" ||
+      typeof pkConfig.definition === "number" ||
+      typeof pkConfig.definition === "symbol"
         ? String((rawKey as any)[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')
+        typeof skConfig.definition === "string" ||
+        typeof skConfig.definition === "number" ||
+        typeof skConfig.definition === "symbol"
           ? String((rawKey as any)[skConfig.definition])
           : skConfig.definition.build(rawKey);
     }
     return keyObj;
   }
-  
+
   /**
    * Build index attributes for each defined GSI.
    */
@@ -175,23 +184,23 @@ export class BetterDDB<T> {
     if (this.keys.gsis) {
       for (const gsiName in this.keys.gsis) {
         const gsiConfig = this.keys.gsis[gsiName];
-  
+
         // Compute primary index attribute.
-        const primaryConfig = gsiConfig.primary;
+        const primaryConfig = gsiConfig!.primary;
         indexAttributes[primaryConfig.name] =
-          (typeof primaryConfig.definition === 'string' ||
-           typeof primaryConfig.definition === 'number' ||
-           typeof primaryConfig.definition === 'symbol')
+          typeof primaryConfig.definition === "string" ||
+          typeof primaryConfig.definition === "number" ||
+          typeof primaryConfig.definition === "symbol"
             ? String((rawItem as any)[primaryConfig.definition])
             : primaryConfig.definition.build(rawItem);
-  
+
         // Compute sort index attribute if provided.
-        if (gsiConfig.sort) {
+        if (gsiConfig?.sort) {
           const sortConfig = gsiConfig.sort;
           indexAttributes[sortConfig.name] =
-            (typeof sortConfig.definition === 'string' ||
-             typeof sortConfig.definition === 'number' ||
-             typeof sortConfig.definition === 'symbol')
+            typeof sortConfig.definition === "string" ||
+            typeof sortConfig.definition === "number" ||
+            typeof sortConfig.definition === "symbol"
               ? String((rawItem as any)[sortConfig.definition])
               : sortConfig.definition.build(rawItem);
         }
@@ -199,7 +208,7 @@ export class BetterDDB<T> {
     }
     return indexAttributes;
   }
-  
+
   /**
    * Create an item:
    * - Computes primary key and index attributes,
@@ -209,7 +218,7 @@ export class BetterDDB<T> {
   public create(item: T): CreateBuilder<T> {
     return new CreateBuilder<T>(this, item);
   }
-  
+
   /**
    * Get an item by its primary key.
    */
@@ -247,7 +256,7 @@ export class BetterDDB<T> {
 
   /**
    * Scan for items.
-   */ 
+   */
   public scan(): ScanBuilder<T> {
     return new ScanBuilder<T>(this);
   }