@ftschopp/dynatable-core 1.0.0

package/dist/builders/query/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,12 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { Condition } from '../shared';
+import { ScanBuilder } from './types';
+import { DynamoDBLogger } from '../../utils/dynamodb-logger';
+/**
+ * Creates a ScanBuilder for scanning a table or index.
+ */
+export declare function createScanBuilder<Model>(tableName: string, client: DynamoDBClient, filters?: Condition[], projectionAttrs?: (keyof Model)[], limitValue?: number, isConsistentRead?: boolean, indexName?: string, exclusiveStartKey?: Record<string, any>, segmentConfig?: {
+    segment: number;
+    totalSegments: number;
+}, logger?: DynamoDBLogger): ScanBuilder<Model>;
+//# sourceMappingURL=create-scan-builder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-scan-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/scan/create-scan-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAgC,SAAS,EAAmB,MAAM,WAAW,CAAC;AACrF,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAE7D;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,EACtB,OAAO,GAAE,SAAS,EAAO,EACzB,eAAe,GAAE,CAAC,MAAM,KAAK,CAAC,EAAO,EACrC,UAAU,CAAC,EAAE,MAAM,EACnB,gBAAgB,UAAQ,EACxB,SAAS,CAAC,EAAE,MAAM,EAClB,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACvC,aAAa,CAAC,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,EAC1D,MAAM,CAAC,EAAE,cAAc,GACtB,WAAW,CAAC,KAAK,CAAC,CAmMpB"}

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

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createScanBuilder = createScanBuilder;
+const lib_dynamodb_1 = require("@aws-sdk/lib-dynamodb");
+const shared_1 = require("../shared");
+/**
+ * Creates a ScanBuilder for scanning a table or index.
+ */
+function createScanBuilder(tableName, client, filters = [], projectionAttrs = [], limitValue, isConsistentRead = false, indexName, exclusiveStartKey, segmentConfig, logger) {
+    const build = () => ({
+        filter(fn) {
+            const attrs = new Proxy({}, {
+                get(_, prop) {
+                    return { name: prop };
+                },
+            });
+            const opBuilder = (0, shared_1.createOpBuilder)();
+            const condition = fn(attrs, opBuilder);
+            return createScanBuilder(tableName, client, [...filters, condition], projectionAttrs, limitValue, isConsistentRead, indexName, exclusiveStartKey, segmentConfig, logger);
+        },
+        select(attrs) {
+            return createScanBuilder(tableName, client, filters, attrs, limitValue, isConsistentRead, indexName, exclusiveStartKey, segmentConfig, logger);
+        },
+        limit(count) {
+            return createScanBuilder(tableName, client, filters, projectionAttrs, count, isConsistentRead, indexName, exclusiveStartKey, segmentConfig, logger);
+        },
+        consistentRead() {
+            return createScanBuilder(tableName, client, filters, projectionAttrs, limitValue, true, indexName, exclusiveStartKey, segmentConfig, logger);
+        },
+        usingIndex(index) {
+            return createScanBuilder(tableName, client, filters, projectionAttrs, limitValue, isConsistentRead, index, exclusiveStartKey, segmentConfig, logger);
+        },
+        startFrom(key) {
+            return createScanBuilder(tableName, client, filters, projectionAttrs, limitValue, isConsistentRead, indexName, key, segmentConfig, logger);
+        },
+        segment(segmentNumber, totalSegments) {
+            return createScanBuilder(tableName, client, filters, projectionAttrs, limitValue, isConsistentRead, indexName, exclusiveStartKey, { segment: segmentNumber, totalSegments }, logger);
+        },
+        dbParams() {
+            let filterExpression = '';
+            let expressionAttributeNames = {};
+            let expressionAttributeValues = {};
+            // Build FilterExpression from filters
+            if (filters.length > 0) {
+                const combinedFilter = filters.length === 1 && filters[0]
+                    ? filters[0]
+                    : {
+                        expression: '',
+                        operator: 'AND',
+                        children: filters,
+                    };
+                const result = (0, shared_1.buildExpression)(combinedFilter);
+                filterExpression = result.expression;
+                expressionAttributeNames = result.names;
+                expressionAttributeValues = result.values;
+            }
+            // Build ProjectionExpression
+            let projectionExpression = '';
+            if (projectionAttrs.length > 0) {
+                projectionExpression = projectionAttrs.map((attr) => String(attr)).join(', ');
+            }
+            const params = {
+                TableName: tableName,
+            };
+            if (filterExpression) {
+                params.FilterExpression = filterExpression;
+            }
+            if (Object.keys(expressionAttributeNames).length > 0) {
+                params.ExpressionAttributeNames = expressionAttributeNames;
+            }
+            if (Object.keys(expressionAttributeValues).length > 0) {
+                params.ExpressionAttributeValues = expressionAttributeValues;
+            }
+            if (projectionExpression) {
+                params.ProjectionExpression = projectionExpression;
+            }
+            if (limitValue !== undefined) {
+                params.Limit = limitValue;
+            }
+            if (isConsistentRead) {
+                params.ConsistentRead = true;
+            }
+            if (indexName) {
+                params.IndexName = indexName;
+            }
+            if (exclusiveStartKey) {
+                params.ExclusiveStartKey = exclusiveStartKey;
+            }
+            if (segmentConfig) {
+                params.Segment = segmentConfig.segment;
+                params.TotalSegments = segmentConfig.totalSegments;
+            }
+            return params;
+        },
+        async execute() {
+            const params = build().dbParams();
+            const response = await client.send(new lib_dynamodb_1.ScanCommand(params));
+            logger?.log('ScanCommand', params, response);
+            return (response.Items || []);
+        },
+    });
+    return build();
+}

package/dist/builders/scan/index.d.ts

@@ -0,0 +1,3 @@
+export * from './types';
+export * from './create-scan-builder';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/scan/index.d.ts.map

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

package/dist/builders/scan/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./create-scan-builder"), exports);

package/dist/builders/scan/types.d.ts

@@ -0,0 +1,43 @@
+import { ExecutableBuilder, AttrBuilder, OpBuilder, Condition } from '../shared';
+/**
+ * Builder for DynamoDB Scan operations.
+ * Scans the entire table or index without requiring key conditions.
+ */
+export interface ScanBuilder<Model> extends ExecutableBuilder<Model[]> {
+    /**
+     * Adds a filter expression to the scan.
+     * Returns a new immutable builder.
+     */
+    filter(fn: (attr: AttrBuilder<Model>, op: OpBuilder) => Condition): ScanBuilder<Model>;
+    /**
+     * Adds a projection expression to only return specific attributes.
+     * Returns a new immutable builder.
+     */
+    select(attrs: (keyof Model)[]): ScanBuilder<Model>;
+    /**
+     * Sets the maximum number of items to evaluate (not necessarily return).
+     * Returns a new immutable builder.
+     */
+    limit(count: number): ScanBuilder<Model>;
+    /**
+     * Enables consistent read (eventual consistency is default).
+     * Returns a new immutable builder.
+     */
+    consistentRead(): ScanBuilder<Model>;
+    /**
+     * Specifies an index to scan.
+     * Returns a new immutable builder.
+     */
+    usingIndex(indexName: string): ScanBuilder<Model>;
+    /**
+     * Sets the starting position for the scan (pagination).
+     * Returns a new immutable builder.
+     */
+    startFrom(exclusiveStartKey: Record<string, any>): ScanBuilder<Model>;
+    /**
+     * Enables parallel scan by specifying segment and total segments.
+     * Returns a new immutable builder.
+     */
+    segment(segmentNumber: number, totalSegments: number): ScanBuilder<Model>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/scan/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/builders/scan/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEjF;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,KAAK,CAAE,SAAQ,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACpE;;;OAGG;IACH,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,KAAK,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEvF;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEnD;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEzC;;;OAGG;IACH,cAAc,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC;IAErC;;;OAGG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAElD;;;OAGG;IACH,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAEtE;;;OAGG;IACH,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;CAC3E"}

package/dist/builders/scan/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/builders/shared/conditions.d.ts

@@ -0,0 +1,18 @@
+import { Condition } from './types';
+/**
+ * Builds a DynamoDB expression from a condition tree
+ */
+export declare function buildExpression(condition: Condition): {
+    expression: string;
+    names: Record<string, string>;
+    values: Record<string, any>;
+};
+/**
+ * Combines multiple conditions into a DynamoDB-compatible expression object.
+ */
+export declare function buildConditionExpr(conditions: Condition[]): {
+    ConditionExpression: string | undefined;
+    ExpressionAttributeNames: any;
+    ExpressionAttributeValues: any;
+};
+//# sourceMappingURL=conditions.d.ts.map

package/dist/builders/shared/conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditions.d.ts","sourceRoot":"","sources":["../../../src/builders/shared/conditions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC7B,CAiCA;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,SAAS,EAAE;;;;EAUzD"}

package/dist/builders/shared/conditions.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildExpression = buildExpression;
+exports.buildConditionExpr = buildConditionExpr;
+/**
+ * Builds a DynamoDB expression from a condition tree
+ */
+function buildExpression(condition) {
+    const names = {};
+    const values = {};
+    function processCondition(cond) {
+        // If it's a combinator (AND/OR)
+        if (cond.operator && cond.children) {
+            const childExpressions = cond.children
+                .map((child) => processCondition(child))
+                .filter((expr) => expr.length > 0);
+            if (childExpressions.length === 0)
+                return '';
+            if (childExpressions.length === 1)
+                return childExpressions[0];
+            const combined = childExpressions.map((expr) => `(${expr})`).join(` ${cond.operator} `);
+            return cond.isNegated ? `NOT (${combined})` : combined;
+        }
+        // It's a leaf condition
+        if (cond.names) {
+            Object.assign(names, cond.names);
+        }
+        if (cond.values) {
+            Object.assign(values, cond.values);
+        }
+        return cond.isNegated ? `NOT (${cond.expression})` : cond.expression;
+    }
+    const expression = processCondition(condition);
+    return { expression, names, values };
+}
+/**
+ * Combines multiple conditions into a DynamoDB-compatible expression object.
+ */
+function buildConditionExpr(conditions) {
+    const expression = conditions.map((c) => c.expression).join(' AND ');
+    const names = Object.assign({}, ...conditions.map((c) => c.names ?? {}));
+    const values = Object.assign({}, ...conditions.map((c) => c.values ?? {}));
+    return {
+        ConditionExpression: expression || undefined,
+        ExpressionAttributeNames: Object.keys(names).length ? names : undefined,
+        ExpressionAttributeValues: Object.keys(values).length ? values : undefined,
+    };
+}

package/dist/builders/shared/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types';
+export * from './operators';
+export * from './conditions';
+//# sourceMappingURL=index.d.ts.map

package/dist/builders/shared/index.d.ts.map

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

package/dist/builders/shared/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+__exportStar(require("./operators"), exports);
+__exportStar(require("./conditions"), exports);

package/dist/builders/shared/operators.d.ts

@@ -0,0 +1,12 @@
+import { OpBuilder } from './types';
+/**
+ * Creates a scoped OpBuilder with its own counter for unique value placeholders.
+ * Each builder instance maintains isolated state to prevent naming conflicts.
+ */
+export declare function createOpBuilder(): OpBuilder;
+/**
+ * @deprecated Use createOpBuilder() instead to avoid global state.
+ * This export is maintained for backward compatibility.
+ */
+export declare const opBuilder: OpBuilder;
+//# sourceMappingURL=operators.d.ts.map

package/dist/builders/shared/operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operators.d.ts","sourceRoot":"","sources":["../../../src/builders/shared/operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC;;;GAGG;AACH,wBAAgB,eAAe,IAAI,SAAS,CA2L3C;AAED;;;GAGG;AACH,eAAO,MAAM,SAAS,EAAE,SAA6B,CAAC"}

package/dist/builders/shared/operators.js

@@ -0,0 +1,197 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.opBuilder = void 0;
+exports.createOpBuilder = createOpBuilder;
+/**
+ * Creates a scoped OpBuilder with its own counter for unique value placeholders.
+ * Each builder instance maintains isolated state to prevent naming conflicts.
+ */
+function createOpBuilder() {
+    let valueCounter = 0;
+    /**
+     * Generates a unique value placeholder name within this builder's scope
+     */
+    function getUniqueValueName(baseName) {
+        return `${baseName}_${valueCounter++}`;
+    }
+    return {
+        eq: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} = :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        ne: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} <> :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        lt: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} < :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        lte: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} <= :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        gt: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} > :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        gte: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `#${attr.name} >= :${valueName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        between: (attr, low, high) => {
+            const lowName = getUniqueValueName(`${attr.name}_low`);
+            const highName = getUniqueValueName(`${attr.name}_high`);
+            return {
+                expression: `#${attr.name} BETWEEN :${lowName} AND :${highName}`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: {
+                    [`:${lowName}`]: low,
+                    [`:${highName}`]: high,
+                },
+            };
+        },
+        beginsWith: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `begins_with(#${attr.name}, :${valueName})`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        contains: (attr, value) => {
+            const valueName = getUniqueValueName(attr.name);
+            return {
+                expression: `contains(#${attr.name}, :${valueName})`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: value },
+            };
+        },
+        exists: (attr) => ({
+            expression: `attribute_exists(#${attr.name})`,
+            names: { [`#${attr.name}`]: attr.name },
+        }),
+        notExists: (attr) => ({
+            expression: `attribute_not_exists(#${attr.name})`,
+            names: { [`#${attr.name}`]: attr.name },
+        }),
+        attributeType: (attr, type) => {
+            const valueName = getUniqueValueName(`${attr.name}_type`);
+            return {
+                expression: `attribute_type(#${attr.name}, :${valueName})`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: { [`:${valueName}`]: type },
+            };
+        },
+        in: (attr, values) => {
+            const valueNames = values.map((_, i) => getUniqueValueName(`${attr.name}_in${i}`));
+            const placeholders = valueNames.map((name) => `:${name}`).join(', ');
+            const valuesObj = {};
+            valueNames.forEach((name, i) => {
+                valuesObj[`:${name}`] = values[i];
+            });
+            return {
+                expression: `#${attr.name} IN (${placeholders})`,
+                names: { [`#${attr.name}`]: attr.name },
+                values: valuesObj,
+            };
+        },
+        size: (attr) => {
+            const sizeExpr = `size(#${attr.name})`;
+            const names = { [`#${attr.name}`]: attr.name };
+            return {
+                eq: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} = :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+                ne: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} <> :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+                lt: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} < :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+                lte: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} <= :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+                gt: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} > :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+                gte: (value) => {
+                    const valueName = getUniqueValueName(`${attr.name}_size`);
+                    return {
+                        expression: `${sizeExpr} >= :${valueName}`,
+                        names,
+                        values: { [`:${valueName}`]: value },
+                    };
+                },
+            };
+        },
+        and: (...conditions) => ({
+            expression: '',
+            operator: 'AND',
+            children: conditions,
+        }),
+        or: (...conditions) => ({
+            expression: '',
+            operator: 'OR',
+            children: conditions,
+        }),
+        not: (condition) => ({
+            ...condition,
+            isNegated: true,
+        }),
+    };
+}
+/**
+ * @deprecated Use createOpBuilder() instead to avoid global state.
+ * This export is maintained for backward compatibility.
+ */
+exports.opBuilder = createOpBuilder();

package/dist/builders/shared/types.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Shared types for DynamoDB builders
+ */
+/**
+ * Condition object for DynamoDB expressions
+ */
+export type Condition = {
+    expression: string;
+    names?: Record<string, string>;
+    values?: Record<string, any>;
+    operator?: 'AND' | 'OR';
+    isNegated?: boolean;
+    children?: Condition[];
+};
+/**
+ * Attribute reference for building expressions
+ */
+export type AttrRef = {
+    name: string;
+    path?: string;
+};
+/**
+ * Type-safe attribute builder for models
+ * Note: All properties are required (non-optional) to ensure type safety in expressions
+ */
+export type AttrBuilder<Model> = {
+    [K in keyof Model]-?: AttrRef;
+};
+/**
+ * Available operators for building conditions
+ */
+export type OpBuilder = {
+    eq: (attr: AttrRef, value: any) => Condition;
+    ne: (attr: AttrRef, value: any) => Condition;
+    lt: (attr: AttrRef, value: any) => Condition;
+    lte: (attr: AttrRef, value: any) => Condition;
+    gt: (attr: AttrRef, value: any) => Condition;
+    gte: (attr: AttrRef, value: any) => Condition;
+    between: (attr: AttrRef, low: any, high: any) => Condition;
+    beginsWith: (attr: AttrRef, value: string) => Condition;
+    contains: (attr: AttrRef, value: any) => Condition;
+    exists: (attr: AttrRef) => Condition;
+    notExists: (attr: AttrRef) => Condition;
+    attributeType: (attr: AttrRef, type: 'S' | 'N' | 'B' | 'SS' | 'NS' | 'BS' | 'M' | 'L' | 'NULL' | 'BOOL') => Condition;
+    in: (attr: AttrRef, values: any[]) => Condition;
+    size: (attr: AttrRef) => SizeRef;
+    and: (...conditions: Condition[]) => Condition;
+    or: (...conditions: Condition[]) => Condition;
+    not: (condition: Condition) => Condition;
+};
+/**
+ * Reference to the size() function result for comparisons
+ */
+export type SizeRef = {
+    eq: (value: number) => Condition;
+    ne: (value: number) => Condition;
+    lt: (value: number) => Condition;
+    lte: (value: number) => Condition;
+    gt: (value: number) => Condition;
+    gte: (value: number) => Condition;
+};
+/**
+ * Base interface for executable builders
+ */
+export interface ExecutableBuilder<Result> {
+    dbParams(): any;
+    execute(): Promise<Result>;
+}
+/**
+ * Base interface for operation builders with conditions
+ */
+export interface OperationBuilder<Model> {
+    where(fn: (attr: AttrBuilder<Model>, op: OpBuilder) => Condition): this;
+    dbParams(): any;
+    execute(): Promise<Model>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/builders/shared/types.d.ts.map

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

package/dist/builders/shared/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/**
+ * Shared types for DynamoDB builders
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/builders/transact-get/create-transact-get-builder.d.ts

@@ -0,0 +1,18 @@
+import { DynamoDBClient } from '@aws-sdk/client-dynamodb';
+import { TransactGetBuilder } from './types';
+/**
+ * Creates a new TransactGet builder
+ *
+ * @param client - DynamoDB client instance
+ * @returns A TransactGetBuilder
+ *
+ * @example
+ * ```typescript
+ * const [user, photo] = await createTransactGetBuilder(client)
+ *   .addGet(getUserParams)
+ *   .addGet(getPhotoParams)
+ *   .execute();
+ * ```
+ */
+export declare const createTransactGetBuilder: (client: DynamoDBClient) => TransactGetBuilder;
+//# sourceMappingURL=create-transact-get-builder.d.ts.map

package/dist/builders/transact-get/create-transact-get-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-transact-get-builder.d.ts","sourceRoot":"","sources":["../../../src/builders/transact-get/create-transact-get-builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,OAAO,EAAE,kBAAkB,EAAoB,MAAM,SAAS,CAAC;AA8C/D;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB,GAAI,QAAQ,cAAc,KAAG,kBAGjE,CAAC"}