dyno-table 1.0.0-alpha.1 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +751 -172
- package/dist/builder-types-C_PDZhnP.d.ts +118 -0
- package/dist/builder-types-DtwbqMeF.d.cts +118 -0
- package/dist/builders/condition-check-builder.cjs +394 -0
- package/dist/builders/condition-check-builder.cjs.map +1 -0
- package/dist/builders/condition-check-builder.d.cts +157 -0
- package/dist/builders/condition-check-builder.d.ts +157 -0
- package/dist/builders/condition-check-builder.js +392 -0
- package/dist/builders/condition-check-builder.js.map +1 -0
- package/dist/builders/delete-builder.cjs +405 -0
- package/dist/builders/delete-builder.cjs.map +1 -0
- package/dist/builders/delete-builder.d.cts +166 -0
- package/dist/builders/delete-builder.d.ts +166 -0
- package/dist/builders/delete-builder.js +403 -0
- package/dist/builders/delete-builder.js.map +1 -0
- package/dist/builders/paginator.cjs +199 -0
- package/dist/builders/paginator.cjs.map +1 -0
- package/dist/builders/paginator.d.cts +179 -0
- package/dist/builders/paginator.d.ts +179 -0
- package/dist/builders/paginator.js +197 -0
- package/dist/builders/paginator.js.map +1 -0
- package/dist/builders/put-builder.cjs +476 -0
- package/dist/builders/put-builder.cjs.map +1 -0
- package/dist/builders/put-builder.d.cts +274 -0
- package/dist/builders/put-builder.d.ts +274 -0
- package/dist/builders/put-builder.js +474 -0
- package/dist/builders/put-builder.js.map +1 -0
- package/dist/builders/query-builder.cjs +674 -0
- package/dist/builders/query-builder.cjs.map +1 -0
- package/dist/builders/query-builder.d.cts +6 -0
- package/dist/builders/query-builder.d.ts +6 -0
- package/dist/builders/query-builder.js +672 -0
- package/dist/builders/query-builder.js.map +1 -0
- package/dist/builders/transaction-builder.cjs +894 -0
- package/dist/builders/transaction-builder.cjs.map +1 -0
- package/dist/builders/transaction-builder.d.cts +511 -0
- package/dist/builders/transaction-builder.d.ts +511 -0
- package/dist/builders/transaction-builder.js +892 -0
- package/dist/builders/transaction-builder.js.map +1 -0
- package/dist/builders/update-builder.cjs +627 -0
- package/dist/builders/update-builder.cjs.map +1 -0
- package/dist/builders/update-builder.d.cts +365 -0
- package/dist/builders/update-builder.d.ts +365 -0
- package/dist/builders/update-builder.js +625 -0
- package/dist/builders/update-builder.js.map +1 -0
- package/dist/conditions--ld9a78i.d.ts +331 -0
- package/dist/conditions-ChhQWd6z.d.cts +331 -0
- package/dist/conditions.cjs +59 -0
- package/dist/conditions.cjs.map +1 -0
- package/dist/conditions.d.cts +3 -0
- package/dist/conditions.d.ts +3 -0
- package/dist/conditions.js +43 -0
- package/dist/conditions.js.map +1 -0
- package/dist/entity.cjs +228 -0
- package/dist/entity.cjs.map +1 -0
- package/dist/entity.d.cts +149 -0
- package/dist/entity.d.ts +149 -0
- package/dist/entity.js +224 -0
- package/dist/entity.js.map +1 -0
- package/dist/query-builder-Csror9Iu.d.ts +507 -0
- package/dist/query-builder-D2FM9rsu.d.cts +507 -0
- package/dist/standard-schema.cjs +4 -0
- package/dist/standard-schema.cjs.map +1 -0
- package/dist/standard-schema.d.cts +57 -0
- package/dist/standard-schema.d.ts +57 -0
- package/dist/standard-schema.js +3 -0
- package/dist/standard-schema.js.map +1 -0
- package/dist/table-BEhBPy2G.d.cts +364 -0
- package/dist/table-BW3cmUqr.d.ts +364 -0
- package/dist/{index.js → table.cjs} +88 -127
- package/dist/table.cjs.map +1 -0
- package/dist/table.d.cts +12 -0
- package/dist/table.d.ts +12 -0
- package/dist/{index.cjs → table.js} +86 -176
- package/dist/table.js.map +1 -0
- package/dist/types.cjs +4 -0
- package/dist/types.cjs.map +1 -0
- package/dist/types.d.cts +22 -0
- package/dist/types.d.ts +22 -0
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -0
- package/dist/utils/partition-key-template.cjs +19 -0
- package/dist/utils/partition-key-template.cjs.map +1 -0
- package/dist/utils/partition-key-template.d.cts +32 -0
- package/dist/utils/partition-key-template.d.ts +32 -0
- package/dist/utils/partition-key-template.js +17 -0
- package/dist/utils/partition-key-template.js.map +1 -0
- package/dist/utils/sort-key-template.cjs +19 -0
- package/dist/utils/sort-key-template.cjs.map +1 -0
- package/dist/utils/sort-key-template.d.cts +35 -0
- package/dist/utils/sort-key-template.d.ts +35 -0
- package/dist/utils/sort-key-template.js +17 -0
- package/dist/utils/sort-key-template.js.map +1 -0
- package/package.json +77 -7
- package/dist/index.d.cts +0 -2971
- package/dist/index.d.ts +0 -2971
package/dist/entity.js
ADDED
|
@@ -0,0 +1,224 @@
|
|
|
1
|
+
// src/conditions.ts
|
|
2
|
+
var createComparisonCondition = (type) => (attr, value) => ({
|
|
3
|
+
type,
|
|
4
|
+
attr,
|
|
5
|
+
value
|
|
6
|
+
});
|
|
7
|
+
var eq = createComparisonCondition("eq");
|
|
8
|
+
|
|
9
|
+
// src/entity.ts
|
|
10
|
+
function defineEntity(config) {
|
|
11
|
+
const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? "entityType";
|
|
12
|
+
const generateTimestamps = () => {
|
|
13
|
+
const timestamps = {};
|
|
14
|
+
if (config.settings?.timestamps) {
|
|
15
|
+
const now = /* @__PURE__ */ new Date();
|
|
16
|
+
if (config.settings.timestamps.createdAt) {
|
|
17
|
+
const attributeName = config.settings.timestamps.createdAt.attributeName ?? "createdAt";
|
|
18
|
+
timestamps[attributeName] = config.settings.timestamps.createdAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
|
|
19
|
+
}
|
|
20
|
+
if (config.settings.timestamps.updatedAt) {
|
|
21
|
+
const attributeName = config.settings.timestamps.updatedAt.attributeName ?? "updatedAt";
|
|
22
|
+
timestamps[attributeName] = config.settings.timestamps.updatedAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
return timestamps;
|
|
26
|
+
};
|
|
27
|
+
return {
|
|
28
|
+
name: config.name,
|
|
29
|
+
createRepository: (table) => {
|
|
30
|
+
const repository = {
|
|
31
|
+
create: (data) => {
|
|
32
|
+
const builder = table.create({
|
|
33
|
+
...data,
|
|
34
|
+
[entityTypeAttributeName]: config.name,
|
|
35
|
+
...generateTimestamps()
|
|
36
|
+
});
|
|
37
|
+
const originalExecute = builder.execute;
|
|
38
|
+
builder.execute = async () => {
|
|
39
|
+
const validationResult = await config.schema["~standard"].validate(data);
|
|
40
|
+
if ("issues" in validationResult && validationResult.issues) {
|
|
41
|
+
throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(", ")}`);
|
|
42
|
+
}
|
|
43
|
+
const primaryKey = config.primaryKey.generateKey(validationResult.value);
|
|
44
|
+
const indexes = Object.entries(config.indexes ?? {}).reduce(
|
|
45
|
+
(acc, [indexName, index]) => {
|
|
46
|
+
const key = index.generateKey(validationResult.value);
|
|
47
|
+
const gsiConfig = table.gsis[indexName];
|
|
48
|
+
if (!gsiConfig) {
|
|
49
|
+
throw new Error(`GSI configuration not found for index: ${indexName}`);
|
|
50
|
+
}
|
|
51
|
+
if (key.pk) {
|
|
52
|
+
acc[gsiConfig.partitionKey] = key.pk;
|
|
53
|
+
}
|
|
54
|
+
if (key.sk && gsiConfig.sortKey) {
|
|
55
|
+
acc[gsiConfig.sortKey] = key.sk;
|
|
56
|
+
}
|
|
57
|
+
return acc;
|
|
58
|
+
},
|
|
59
|
+
{}
|
|
60
|
+
);
|
|
61
|
+
Object.assign(builder, {
|
|
62
|
+
item: {
|
|
63
|
+
...validationResult.value,
|
|
64
|
+
[entityTypeAttributeName]: config.name,
|
|
65
|
+
[table.partitionKey]: primaryKey.pk,
|
|
66
|
+
...table.sortKey ? { [table.sortKey]: primaryKey.sk } : {},
|
|
67
|
+
...indexes,
|
|
68
|
+
...generateTimestamps()
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
return await originalExecute.call(builder);
|
|
72
|
+
};
|
|
73
|
+
return builder;
|
|
74
|
+
},
|
|
75
|
+
upsert: (data) => {
|
|
76
|
+
const primaryKey = config.primaryKey.generateKey(data);
|
|
77
|
+
const builder = table.put({
|
|
78
|
+
[table.partitionKey]: primaryKey.pk,
|
|
79
|
+
...table.sortKey ? { [table.sortKey]: primaryKey.sk } : {},
|
|
80
|
+
...data,
|
|
81
|
+
[entityTypeAttributeName]: config.name,
|
|
82
|
+
...generateTimestamps()
|
|
83
|
+
});
|
|
84
|
+
const originalExecute = builder.execute;
|
|
85
|
+
builder.execute = async () => {
|
|
86
|
+
const validationResult = await config.schema["~standard"].validate(data);
|
|
87
|
+
if ("issues" in validationResult && validationResult.issues) {
|
|
88
|
+
throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(", ")}`);
|
|
89
|
+
}
|
|
90
|
+
Object.assign(builder, {
|
|
91
|
+
item: {
|
|
92
|
+
...validationResult.value,
|
|
93
|
+
[entityTypeAttributeName]: config.name,
|
|
94
|
+
...generateTimestamps()
|
|
95
|
+
}
|
|
96
|
+
});
|
|
97
|
+
const result = await originalExecute.call(builder);
|
|
98
|
+
if (!result) {
|
|
99
|
+
throw new Error("Failed to upsert item");
|
|
100
|
+
}
|
|
101
|
+
return result;
|
|
102
|
+
};
|
|
103
|
+
return builder;
|
|
104
|
+
},
|
|
105
|
+
get: (key) => {
|
|
106
|
+
const primaryKeyObj = config.primaryKey.generateKey(key);
|
|
107
|
+
return table.get(primaryKeyObj);
|
|
108
|
+
},
|
|
109
|
+
update: (key, data) => {
|
|
110
|
+
const primaryKeyObj = config.primaryKey.generateKey(key);
|
|
111
|
+
const builder = table.update(primaryKeyObj);
|
|
112
|
+
builder.condition(eq(entityTypeAttributeName, config.name));
|
|
113
|
+
const timestamps = {};
|
|
114
|
+
if (config.settings?.timestamps?.updatedAt) {
|
|
115
|
+
const now = /* @__PURE__ */ new Date();
|
|
116
|
+
const attributeName = config.settings.timestamps.updatedAt.attributeName ?? "updatedAt";
|
|
117
|
+
timestamps[attributeName] = config.settings.timestamps.updatedAt.format === "UNIX" ? Math.floor(Date.now() / 1e3) : now.toISOString();
|
|
118
|
+
}
|
|
119
|
+
builder.set({
|
|
120
|
+
...data,
|
|
121
|
+
...timestamps
|
|
122
|
+
});
|
|
123
|
+
return builder;
|
|
124
|
+
},
|
|
125
|
+
delete: (key) => {
|
|
126
|
+
const primaryKeyObj = config.primaryKey.generateKey(key);
|
|
127
|
+
const builder = table.delete(primaryKeyObj);
|
|
128
|
+
builder.condition(eq(entityTypeAttributeName, config.name));
|
|
129
|
+
return builder;
|
|
130
|
+
},
|
|
131
|
+
query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {
|
|
132
|
+
acc[key] = (input) => {
|
|
133
|
+
const queryEntity = {
|
|
134
|
+
scan: repository.scan,
|
|
135
|
+
get: (key2) => table.get(key2),
|
|
136
|
+
query: (keyCondition) => {
|
|
137
|
+
return table.query(keyCondition);
|
|
138
|
+
}
|
|
139
|
+
};
|
|
140
|
+
const queryBuilderCallback = inputCallback(input);
|
|
141
|
+
const builder = queryBuilderCallback(queryEntity);
|
|
142
|
+
if (builder && typeof builder === "object" && "filter" in builder && typeof builder.filter === "function") {
|
|
143
|
+
builder.filter(eq(entityTypeAttributeName, config.name));
|
|
144
|
+
}
|
|
145
|
+
if (builder && typeof builder === "object" && "execute" in builder) {
|
|
146
|
+
const originalExecute = builder.execute;
|
|
147
|
+
builder.execute = async () => {
|
|
148
|
+
const queryFn = config.queries[key];
|
|
149
|
+
if (queryFn && typeof queryFn === "function") {
|
|
150
|
+
const schema = queryFn.schema;
|
|
151
|
+
if (schema?.["~standard"]?.validate && typeof schema["~standard"].validate === "function") {
|
|
152
|
+
const validationResult = schema["~standard"].validate(input);
|
|
153
|
+
if ("issues" in validationResult && validationResult.issues) {
|
|
154
|
+
throw new Error(
|
|
155
|
+
`Validation failed: ${validationResult.issues.map((issue) => issue.message).join(", ")}`
|
|
156
|
+
);
|
|
157
|
+
}
|
|
158
|
+
}
|
|
159
|
+
}
|
|
160
|
+
const result = await originalExecute.call(builder);
|
|
161
|
+
if (!result) {
|
|
162
|
+
throw new Error("Failed to execute query");
|
|
163
|
+
}
|
|
164
|
+
return result;
|
|
165
|
+
};
|
|
166
|
+
}
|
|
167
|
+
return builder;
|
|
168
|
+
};
|
|
169
|
+
return acc;
|
|
170
|
+
}, {}),
|
|
171
|
+
scan: () => {
|
|
172
|
+
const scanBuilder = table.scan();
|
|
173
|
+
scanBuilder.filter(eq(entityTypeAttributeName, config.name));
|
|
174
|
+
return scanBuilder;
|
|
175
|
+
}
|
|
176
|
+
};
|
|
177
|
+
return repository;
|
|
178
|
+
}
|
|
179
|
+
};
|
|
180
|
+
}
|
|
181
|
+
function createQueries() {
|
|
182
|
+
return {
|
|
183
|
+
input: (schema) => ({
|
|
184
|
+
query: (handler) => {
|
|
185
|
+
const queryFn = (input) => {
|
|
186
|
+
return (entity) => {
|
|
187
|
+
return handler({ input, entity });
|
|
188
|
+
};
|
|
189
|
+
};
|
|
190
|
+
queryFn.schema = schema;
|
|
191
|
+
return queryFn;
|
|
192
|
+
}
|
|
193
|
+
})
|
|
194
|
+
};
|
|
195
|
+
}
|
|
196
|
+
function createIndex() {
|
|
197
|
+
return {
|
|
198
|
+
input: (schema) => ({
|
|
199
|
+
partitionKey: (pkFn) => ({
|
|
200
|
+
sortKey: (skFn) => ({
|
|
201
|
+
name: "custom",
|
|
202
|
+
partitionKey: "pk",
|
|
203
|
+
sortKey: "sk",
|
|
204
|
+
generateKey: (item) => ({
|
|
205
|
+
pk: pkFn(item),
|
|
206
|
+
sk: skFn(item)
|
|
207
|
+
})
|
|
208
|
+
}),
|
|
209
|
+
// Allow creating an index with only a partition key
|
|
210
|
+
withoutSortKey: () => ({
|
|
211
|
+
name: "custom",
|
|
212
|
+
partitionKey: "pk",
|
|
213
|
+
generateKey: (item) => ({
|
|
214
|
+
pk: pkFn(item)
|
|
215
|
+
})
|
|
216
|
+
})
|
|
217
|
+
})
|
|
218
|
+
})
|
|
219
|
+
};
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
export { createIndex, createQueries, defineEntity };
|
|
223
|
+
//# sourceMappingURL=entity.js.map
|
|
224
|
+
//# sourceMappingURL=entity.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"sources":["../src/conditions.ts","../src/entity.ts"],"names":["key"],"mappings":"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","file":"entity.js","sourcesContent":["import type { Path, PathType } from \"./builders/types\";\nimport type { DynamoItem } from \"./types\";\n\n/**\n * Supported comparison operators for DynamoDB conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Comparison Operator Reference}\n *\n * - eq: Equals (=)\n * - ne: Not equals (≠ / <>)\n * - lt: Less than (<)\n * - lte: Less than or equal to (≤)\n * - gt: Greater than (>)\n * - gte: Greater than or equal to (≥)\n * - between: Between two values (inclusive)\n * - beginsWith: Checks if string attribute begins with specified substring\n * - contains: Checks if string/set attribute contains specified value\n * - attributeExists: Checks if attribute exists\n * - attributeNotExists: Checks if attribute does not exist\n */\nexport type ComparisonOperator =\n | \"eq\"\n | \"ne\"\n | \"lt\"\n | \"lte\"\n | \"gt\"\n | \"gte\"\n | \"between\"\n | \"beginsWith\"\n | \"contains\"\n | \"attributeExists\"\n | \"attributeNotExists\";\n\n/**\n * Logical operators for combining multiple conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - Logical Operator Reference}\n *\n * - and: Evaluates to true if all conditions are true\n * - or: Evaluates to true if any condition is true\n * - not: Negate the result of a condition\n */\nexport type LogicalOperator = \"and\" | \"or\" | \"not\";\n\n/**\n * Represents a DynamoDB condition expression.\n * Can be either a comparison condition or a logical combination of conditions.\n *\n * @example\n * // Simple comparison condition\n * const condition: Condition = {\n * type: \"eq\",\n * attr: \"status\",\n * value: \"ACTIVE\"\n * };\n *\n * @example\n * // Logical combination of conditions\n * const condition: Condition = {\n * type: \"and\",\n * conditions: [\n * { type: \"eq\", attr: \"status\", value: \"ACTIVE\" },\n * { type: \"gt\", attr: \"age\", value: 5 }\n * ]\n * };\n */\nexport interface Condition {\n /** The type of condition (comparison or logical operator) */\n type: ComparisonOperator | LogicalOperator;\n /** The attribute name for comparison conditions */\n attr?: string;\n /** The value to compare against for comparison conditions */\n value?: unknown;\n /** Array of conditions for logical operators (and/or) */\n conditions?: Condition[];\n /** Single condition for the 'not' operator */\n condition?: Condition;\n}\n\n/**\n * Parameters used to build DynamoDB expression strings.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeNames.html Expression Attribute Names}\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.ExpressionAttributeValues.html Expression Attribute Values}\n */\nexport interface ExpressionParams {\n /** Map of attribute name placeholders to actual attribute names */\n expressionAttributeNames: Record<string, string>;\n /** Map of value placeholders to actual values */\n expressionAttributeValues: DynamoItem;\n /** Counter for generating unique value placeholders */\n valueCounter: { count: number };\n}\n\n/**\n * Creates a comparison condition builder function for the specified operator.\n * @internal\n */\nexport const createComparisonCondition =\n (type: ComparisonOperator) =>\n (attr: string, value: unknown): Condition => ({\n type,\n attr,\n value,\n });\n\n/**\n * Creates an equals (=) condition\n * @example\n * eq(\"status\", \"ACTIVE\") // status = \"ACTIVE\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const eq = createComparisonCondition(\"eq\");\n\n/**\n * Creates a not equals (≠) condition\n * @example\n * ne(\"status\", \"DELETED\") // status <> \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const ne = createComparisonCondition(\"ne\");\n\n/**\n * Creates a less than (<) condition\n * @example\n * lt(\"age\", 18) // age < 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lt = createComparisonCondition(\"lt\");\n\n/**\n * Creates a less than or equal to (≤) condition\n * @example\n * lte(\"age\", 18) // age <= 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const lte = createComparisonCondition(\"lte\");\n\n/**\n * Creates a greater than (>) condition\n * @example\n * gt(\"price\", 100) // price > 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gt = createComparisonCondition(\"gt\");\n\n/**\n * Creates a greater than or equal to (≥) condition\n * @example\n * gte(\"price\", 100) // price >= 100\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html}\n */\nexport const gte = createComparisonCondition(\"gte\");\n\n/**\n * Creates a between condition that checks if a value is within a range (inclusive)\n * @example\n * between(\"age\", 18, 65) // age BETWEEN 18 AND 65\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Comparators AWS DynamoDB - BETWEEN}\n */\nexport const between = (attr: string, lower: unknown, upper: unknown): Condition => ({\n type: \"between\",\n attr,\n value: [lower, upper],\n});\n\n/**\n * Creates a begins_with condition that checks if a string attribute starts with a substring\n * @example\n * beginsWith(\"email\", \"@example.com\") // begins_with(email, \"@example.com\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - begins_with}\n */\nexport const beginsWith = createComparisonCondition(\"beginsWith\");\n\n/**\n * Creates a contains condition that checks if a string contains a substring or if a set contains an element\n * @example\n * contains(\"tags\", \"important\") // contains(tags, \"important\")\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - contains}\n */\nexport const contains = createComparisonCondition(\"contains\");\n\n/**\n * Creates a condition that checks if an attribute exists\n * @example\n * attributeExists(\"email\") // attribute_exists(email)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_exists}\n */\nexport const attributeExists = (attr: string): Condition => ({\n type: \"attributeExists\",\n attr,\n});\n\n/**\n * Creates a condition that checks if an attribute does not exist\n * @example\n * attributeNotExists(\"deletedAt\") // attribute_not_exists(deletedAt)\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Functions AWS DynamoDB - attribute_not_exists}\n */\nexport const attributeNotExists = (attr: string): Condition => ({\n type: \"attributeNotExists\",\n attr,\n});\n\n// --- Logical Operators ---\n\n/**\n * Combines multiple conditions with AND operator\n * @example\n * and(\n * eq(\"status\", \"ACTIVE\"),\n * gt(\"age\", 18)\n * ) // status = \"ACTIVE\" AND age > 18\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - AND}\n */\nexport const and = (...conditions: Condition[]): Condition => ({\n type: \"and\",\n conditions,\n});\n\n/**\n * Combines multiple conditions with OR operator\n * @example\n * or(\n * eq(\"status\", \"PENDING\"),\n * eq(\"status\", \"PROCESSING\")\n * ) // status = \"PENDING\" OR status = \"PROCESSING\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - OR}\n */\nexport const or = (...conditions: Condition[]): Condition => ({\n type: \"or\",\n conditions,\n});\n\n/**\n * Negates a condition\n * @example\n * not(eq(\"status\", \"DELETED\")) // NOT status = \"DELETED\"\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html#Expressions.OperatorsAndFunctions.Logical AWS DynamoDB - NOT}\n */\nexport const not = (condition: Condition): Condition => ({\n type: \"not\",\n condition,\n});\n\n/**\n * Type-safe operators for building key conditions in DynamoDB queries.\n * Only includes operators that are valid for key conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html#Query.KeyConditionExpressions AWS DynamoDB - Key Condition Expressions}\n *\n * @example\n * // Using with sort key conditions\n * table.query({\n * pk: \"USER#123\",\n * sk: op => op.beginsWith(\"ORDER#\")\n * })\n */\nexport type KeyConditionOperator = {\n /** Equals comparison for key attributes */\n eq: (value: unknown) => Condition;\n /** Less than comparison for key attributes */\n lt: (value: unknown) => Condition;\n /** Less than or equal comparison for key attributes */\n lte: (value: unknown) => Condition;\n /** Greater than comparison for key attributes */\n gt: (value: unknown) => Condition;\n /** Greater than or equal comparison for key attributes */\n gte: (value: unknown) => Condition;\n /** Between range comparison for key attributes */\n between: (lower: unknown, upper: unknown) => Condition;\n /** Begins with comparison for key attributes */\n beginsWith: (value: unknown) => Condition;\n /** Combines multiple key conditions with AND */\n and: (...conditions: Condition[]) => Condition;\n};\n\n/**\n * Type-safe operators for building conditions in DynamoDB operations.\n * Includes all available condition operators with proper type inference.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Expressions.OperatorsAndFunctions.html AWS DynamoDB - Condition Expressions}\n *\n * @example\n * // Using with type-safe conditions\n * interface User {\n * status: string;\n * age: number;\n * email?: string;\n * }\n *\n * table.scan<User>()\n * .where(op => op.and(\n * op.eq(\"status\", \"ACTIVE\"),\n * op.gt(\"age\", 18),\n * op.attributeExists(\"email\")\n * ))\n *\n * @template T The type of the item being operated on\n */\nexport type ConditionOperator<T extends DynamoItem> = {\n eq: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n ne: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n lt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n lte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n gt: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n gte: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n between: <K extends Path<T>>(attr: K, lower: PathType<T, K>, upper: PathType<T, K>) => Condition;\n beginsWith: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n contains: <K extends Path<T>>(attr: K, value: PathType<T, K>) => Condition;\n attributeExists: <K extends Path<T>>(attr: K) => Condition;\n attributeNotExists: <K extends Path<T>>(attr: K) => Condition;\n and: (...conditions: Condition[]) => Condition;\n or: (...conditions: Condition[]) => Condition;\n not: (condition: Condition) => Condition;\n};\n\n/**\n * Primary key type for QUERY operations.\n * Allows building complex key conditions for the sort key.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Query.html AWS DynamoDB - Query Operations}\n *\n * @example\n * // Query items with a specific partition key and sort key prefix\n * table.query({\n * pk: \"USER#123\",\n * sk: op => op.beginsWith(\"ORDER#2023\")\n * })\n *\n * @example\n * // Query items within a specific sort key range\n * table.query({\n * pk: \"USER#123\",\n * sk: op => op.between(\"ORDER#2023-01\", \"ORDER#2023-12\")\n * })\n */\nexport type PrimaryKey = {\n /** Partition key value */\n pk: string;\n /** Optional sort key condition builder */\n sk?: (op: KeyConditionOperator) => Condition;\n};\n\n/**\n * Primary key type for GET and DELETE operations.\n * Used when you need to specify exact key values without conditions.\n * @see {@link https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/WorkingWithItems.html AWS DynamoDB - Working with Items}\n *\n * @example\n * // Get a specific item by its complete primary key\n * table.get({\n * pk: \"USER#123\",\n * sk: \"PROFILE#123\"\n * })\n *\n * @example\n * // Delete a specific item by its complete primary key\n * table.delete({\n * pk: \"USER#123\",\n * sk: \"ORDER#456\"\n * })\n */\nexport type PrimaryKeyWithoutExpression = {\n /** Partition key value */\n pk: string;\n /** Optional sort key value */\n sk?: string;\n};\n","import type { DeleteBuilder } from \"./builders/delete-builder\";\nimport type { GetBuilder } from \"./builders/get-builder\";\nimport type { PutBuilder } from \"./builders/put-builder\";\nimport type { ScanBuilder } from \"./builders/scan-builder\";\nimport type { UpdateBuilder } from \"./builders/update-builder\";\nimport type { StandardSchemaV1 } from \"./standard-schema\";\nimport type { Table } from \"./table\";\nimport type { DynamoItem, Index, TableConfig } from \"./types\";\nimport { eq, type PrimaryKey, type PrimaryKeyWithoutExpression } from \"./conditions\";\nimport type { QueryBuilder } from \"./builders/query-builder\";\n\n// Define the QueryFunction type with a generic return type\nexport type QueryFunction<T extends DynamoItem, I, R> = (input: I) => R;\n\n// Define a type for the query record that preserves the input type for each query function\nexport type QueryFunctionWithSchema<T extends DynamoItem, I, R> = QueryFunction<T, I, R> & {\n schema?: StandardSchemaV1<I>;\n};\n\nexport type QueryRecord<T extends DynamoItem> = {\n // biome-ignore lint/suspicious/noExplicitAny: This is for flexibility\n [K: string]: QueryFunctionWithSchema<T, any, ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>>;\n};\n\n// Define a type for entity with only scan, get and query methods\nexport type QueryEntity<T extends DynamoItem> = {\n scan: () => ScanBuilder<T>;\n get: (key: PrimaryKeyWithoutExpression) => GetBuilder<T>;\n query: (keyCondition: PrimaryKey) => QueryBuilder<T, TableConfig>;\n};\n\ninterface Settings {\n /**\n * Defaults to \"entityType\"\n */\n entityTypeAttributeName?: string;\n timestamps?: {\n createdAt?: {\n /**\n * ISO vs Unix trade-offs\n *\n * Both options support between, greater than and less than comparisons.\n *\n * ISO:\n * - Human readable, but requires more storage space\n * - Does not work with DynamoDBs TTL feature.\n *\n * UNIX:\n * - Less readable, but requires less storage space.\n * - Works with DynamoDBs TTL feature.\n */\n format: \"ISO\" | \"UNIX\";\n /**\n * Defaults to \"createdAt\"\n */\n attributeName?: string;\n };\n updatedAt?: {\n /**\n * ISO vs Unix trade-offs\n *\n * Both options support between, greater than and less than comparisons.\n *\n * ISO:\n * - Human readable, but requires more storage space\n * - Does not work with DynamoDBs TTL feature.\n *\n * UNIX:\n * - Less readable, but requires less storage space.\n * - Works with DynamoDBs TTL feature.\n */\n format: \"ISO\" | \"UNIX\";\n /**\n * Defaults to \"updatedAt\"\n */\n attributeName?: string;\n };\n };\n}\n\nexport interface EntityConfig<\n T extends DynamoItem,\n I extends DynamoItem = T,\n Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n name: string;\n schema: StandardSchemaV1<T>;\n primaryKey: IndexDefinition<I>;\n indexes?: Record<string, Index>;\n queries: Q;\n settings?: Settings;\n}\n\nexport interface EntityRepository<\n /**\n * The Entity Type\n */\n T extends DynamoItem,\n /**\n * The Primary Index (Partition index) Type\n */\n I extends DynamoItem = T,\n /**\n * The Queries object\n */\n Q extends QueryRecord<T> = QueryRecord<T>,\n> {\n create: (data: T) => PutBuilder<T>;\n upsert: (data: T & I) => PutBuilder<T>;\n get: (key: I) => GetBuilder<T>;\n update: (key: I, data: Partial<T>) => UpdateBuilder<T>;\n delete: (key: I) => DeleteBuilder;\n query: Q;\n scan: () => ScanBuilder<T>;\n}\n\n/**\n * Creates an entity definition with type-safe operations\n *\n * @example\n * ```typescript\n * interface User {\n * id: string;\n * name: string;\n * }\n *\n * const UserEntity = defineEntity<User>({\n * name: \"User\",\n * schema: userSchema,\n * primaryKey: primaryKey,\n * });\n * ```\n */\nexport function defineEntity<T extends DynamoItem, I extends DynamoItem = T, Q extends QueryRecord<T> = QueryRecord<T>>(\n config: EntityConfig<T, I, Q>,\n) {\n const entityTypeAttributeName = config.settings?.entityTypeAttributeName ?? \"entityType\";\n\n /**\n * Generates an object containing timestamp attributes based on the given configuration settings.\n * The function determines the presence and format of \"createdAt\" and \"updatedAt\" timestamps dynamically.\n *\n * @returns {Record<string, string | number>} An object containing one or both of the \"createdAt\" and \"updatedAt\" timestamp attributes, depending on the configuration. Each timestamp can be formatted as either an ISO string or a UNIX timestamp.\n *\n * @throws Will not throw errors but depends on `config.settings?.timestamps` to be properly defined.\n * - If `createdAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.createdAt.attributeName` or defaults to \"createdAt\".\n * - If `updatedAt` is configured, the function adds a timestamp using the attribute name specified in `config.settings.timestamps.updatedAt.attributeName` or defaults to \"updatedAt\".\n *\n * Configuration Details:\n * - `config.settings.timestamps.createdAt.format`: Determines the format of the \"createdAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n * - `config.settings.timestamps.updatedAt.format`: Determines the format of the \"updatedAt\" timestamp. Accepts \"UNIX\" or defaults to ISO string.\n *\n * The returned object keys and values depend on the provided configuration.\n */\n const generateTimestamps = (): Record<string, string | number> => {\n const timestamps: Record<string, string | number> = {};\n\n if (config.settings?.timestamps) {\n const now = new Date();\n\n if (config.settings.timestamps.createdAt) {\n const attributeName = config.settings.timestamps.createdAt.attributeName ?? \"createdAt\";\n timestamps[attributeName] =\n config.settings.timestamps.createdAt.format === \"UNIX\" ? Math.floor(Date.now() / 1000) : now.toISOString();\n }\n\n if (config.settings.timestamps.updatedAt) {\n const attributeName = config.settings.timestamps.updatedAt.attributeName ?? \"updatedAt\";\n timestamps[attributeName] =\n config.settings.timestamps.updatedAt.format === \"UNIX\" ? Math.floor(Date.now() / 1000) : now.toISOString();\n }\n }\n\n return timestamps;\n };\n\n return {\n name: config.name,\n createRepository: (table: Table): EntityRepository<T, I, Q> => {\n // Create a repository\n const repository = {\n create: (data: T) => {\n // We need to handle the async operations when the consumer calls execute\n const builder = table.create<T>({\n ...data,\n [entityTypeAttributeName]: config.name,\n ...generateTimestamps(),\n });\n\n // Wrap the builder's execute method to apply validation only\n const originalExecute = builder.execute;\n builder.execute = async () => {\n // Validate data against schema\n const validationResult = await config.schema[\"~standard\"].validate(data);\n if (\"issues\" in validationResult && validationResult.issues) {\n throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n }\n\n const primaryKey = config.primaryKey.generateKey(validationResult.value as unknown as I);\n\n const indexes = Object.entries(config.indexes ?? {}).reduce(\n (acc, [indexName, index]) => {\n const key = (index as IndexDefinition<T>).generateKey(validationResult.value);\n const gsiConfig = table.gsis[indexName];\n\n if (!gsiConfig) {\n throw new Error(`GSI configuration not found for index: ${indexName}`);\n }\n\n if (key.pk) {\n acc[gsiConfig.partitionKey] = key.pk;\n }\n if (key.sk && gsiConfig.sortKey) {\n acc[gsiConfig.sortKey] = key.sk;\n }\n return acc;\n },\n {} as Record<string, string>,\n );\n\n // Update the item in the builder with the validated data, entity type, and timestamps\n Object.assign(builder, {\n item: {\n ...validationResult.value,\n [entityTypeAttributeName]: config.name,\n [table.partitionKey]: primaryKey.pk,\n ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n ...indexes,\n ...generateTimestamps(),\n },\n });\n\n // Execute the builder\n return await originalExecute.call(builder);\n };\n\n return builder;\n },\n\n upsert: (data: T & I) => {\n const primaryKey = config.primaryKey.generateKey(data);\n\n // We need to handle the async operations when the consumer calls execute\n const builder = table.put<T>({\n [table.partitionKey]: primaryKey.pk,\n ...(table.sortKey ? { [table.sortKey]: primaryKey.sk } : {}),\n ...data,\n [entityTypeAttributeName]: config.name,\n ...generateTimestamps(),\n });\n\n // Wrap the builder's execute method to apply validation only\n const originalExecute = builder.execute;\n builder.execute = async () => {\n // Validate data against schema\n const validationResult = await config.schema[\"~standard\"].validate(data);\n if (\"issues\" in validationResult && validationResult.issues) {\n throw new Error(`Validation failed: ${validationResult.issues.map((i) => i.message).join(\", \")}`);\n }\n\n // Update the item in the builder with the validated data, entity type, and timestamps\n Object.assign(builder, {\n item: {\n ...validationResult.value,\n [entityTypeAttributeName]: config.name,\n ...generateTimestamps(),\n },\n });\n\n // Execute the builder\n const result = await originalExecute.call(builder);\n if (!result) {\n throw new Error(\"Failed to upsert item\");\n }\n\n return result;\n };\n\n return builder;\n },\n\n get: <K extends I>(key: K) => {\n // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n const primaryKeyObj = config.primaryKey.generateKey(key);\n return table.get<T>(primaryKeyObj);\n },\n\n update: <K extends I>(key: K, data: Partial<T>) => {\n // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n const primaryKeyObj = config.primaryKey.generateKey(key);\n const builder = table.update<T>(primaryKeyObj);\n builder.condition(eq(entityTypeAttributeName, config.name));\n\n // Generate updatedAt timestamp if configured\n const timestamps: Record<string, string | number> = {};\n if (config.settings?.timestamps?.updatedAt) {\n const now = new Date();\n const attributeName = config.settings.timestamps.updatedAt.attributeName ?? \"updatedAt\";\n timestamps[attributeName] =\n config.settings.timestamps.updatedAt.format === \"UNIX\"\n ? Math.floor(Date.now() / 1000)\n : now.toISOString();\n }\n\n // Merge the data with timestamps\n builder.set({\n ...data,\n ...timestamps,\n });\n\n return builder;\n },\n\n delete: <K extends I>(key: K) => {\n // Transform the input key into a PrimaryKeyWithoutExpression using the primary key definition\n const primaryKeyObj = config.primaryKey.generateKey(key);\n const builder = table.delete(primaryKeyObj);\n builder.condition(eq(entityTypeAttributeName, config.name));\n return builder;\n },\n\n query: Object.entries(config.queries || {}).reduce((acc, [key, inputCallback]) => {\n // @ts-expect-error - We need to cast the queryFn to a function that takes an unknown input\n acc[key] = (input: unknown) => {\n // Create a QueryEntity object with only the necessary methods\n const queryEntity: QueryEntity<T> = {\n scan: repository.scan,\n get: (key: PrimaryKeyWithoutExpression) => table.get<T>(key),\n query: (keyCondition: PrimaryKey) => {\n return table.query<T>(keyCondition);\n },\n };\n\n // Execute the query function to get the builder - This type is incorrect and needs to be fixed\n const queryBuilderCallback = inputCallback(input);\n\n // Run the inner handler which allows the user to apply their desired contraints\n // to the query builder of their choice\n // @ts-expect-error - We need to cast the queryBuilderCallback to a function that takes a QueryEntity\n const builder = queryBuilderCallback(queryEntity);\n\n // Add entity type filter if the builder has filter method\n if (builder && typeof builder === \"object\" && \"filter\" in builder && typeof builder.filter === \"function\") {\n builder.filter(eq(entityTypeAttributeName, config.name));\n }\n\n // Wrap the builder's execute method if it exists\n if (builder && typeof builder === \"object\" && \"execute\" in builder) {\n const originalExecute = builder.execute;\n builder.execute = async () => {\n // Validate the input before executing the query\n const queryFn = (\n config.queries as unknown as Record<string, QueryFunctionWithSchema<T, I, typeof builder>>\n )[key];\n\n if (queryFn && typeof queryFn === \"function\") {\n // Get the schema from the query function\n const schema = queryFn.schema;\n if (schema?.[\"~standard\"]?.validate && typeof schema[\"~standard\"].validate === \"function\") {\n const validationResult = schema[\"~standard\"].validate(input);\n if (\"issues\" in validationResult && validationResult.issues) {\n throw new Error(\n `Validation failed: ${validationResult.issues.map((issue) => issue.message).join(\", \")}`,\n );\n }\n }\n }\n\n // Execute the original builder\n const result = await originalExecute.call(builder);\n if (!result) {\n throw new Error(\"Failed to execute query\");\n }\n return result;\n };\n }\n\n return builder;\n };\n return acc;\n }, {} as Q),\n\n scan: () => {\n const scanBuilder = table.scan<T>();\n scanBuilder.filter(eq(entityTypeAttributeName, config.name));\n\n return scanBuilder;\n },\n };\n\n return repository;\n },\n };\n}\n\nexport function createQueries<T extends DynamoItem>() {\n return {\n input: <I>(schema: StandardSchemaV1<I>) => ({\n query: <\n Q extends QueryRecord<T> = QueryRecord<T>,\n R = ScanBuilder<T> | QueryBuilder<T, TableConfig> | GetBuilder<T>,\n >(\n handler: (params: { input: I; entity: QueryEntity<T> }) => R,\n ) => {\n // Create a query function that conforms to QueryFunctionWithSchema type\n const queryFn = (input: I) => {\n // This function will be called by the repository later with the real queryEntity\n return (entity: QueryEntity<T>) => {\n return handler({ input, entity });\n };\n };\n\n // Attach the schema to the function for validation purposes\n queryFn.schema = schema;\n\n // Return the query function (this satisfies the QueryFunctionWithSchema type)\n return queryFn as unknown as QueryFunctionWithSchema<T, I, R>;\n },\n }),\n };\n}\n\nexport interface IndexDefinition<T extends DynamoItem> extends Index {\n name: string;\n generateKey: (item: T) => { pk: string; sk?: string };\n}\n\nexport function createIndex() {\n return {\n input: <T extends DynamoItem>(schema: StandardSchemaV1<T>) => ({\n partitionKey: <P extends (item: T) => string>(pkFn: P) => ({\n sortKey: <S extends (item: T) => string>(skFn: S) =>\n ({\n name: \"custom\",\n partitionKey: \"pk\",\n sortKey: \"sk\",\n generateKey: (item: T) => ({\n pk: pkFn(item),\n sk: skFn(item),\n }),\n }) as IndexDefinition<T>,\n\n // Allow creating an index with only a partition key\n withoutSortKey: () =>\n ({\n name: \"custom\",\n partitionKey: \"pk\",\n generateKey: (item: T) => ({\n pk: pkFn(item),\n }),\n }) as IndexDefinition<T>,\n }),\n }),\n };\n}\n"]}
|