convex-verify 1.1.0 → 1.2.2

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.
Files changed (46) hide show
  1. package/README.md +148 -80
  2. package/dist/core/index.d.mts +14 -55
  3. package/dist/core/index.d.ts +14 -55
  4. package/dist/core/index.js +492 -92
  5. package/dist/core/index.js.map +1 -1
  6. package/dist/core/index.mjs +491 -92
  7. package/dist/core/index.mjs.map +1 -1
  8. package/dist/index.d.mts +9 -6
  9. package/dist/index.d.ts +9 -6
  10. package/dist/index.js +378 -271
  11. package/dist/index.js.map +1 -1
  12. package/dist/index.mjs +378 -267
  13. package/dist/index.mjs.map +1 -1
  14. package/dist/types-B8ZkLuJ2.d.mts +141 -0
  15. package/dist/types-B8ZkLuJ2.d.ts +141 -0
  16. package/dist/utils/index.d.mts +3 -2
  17. package/dist/utils/index.d.ts +3 -2
  18. package/dist/utils/index.js +1 -1
  19. package/dist/utils/index.js.map +1 -1
  20. package/dist/utils/index.mjs +1 -1
  21. package/dist/utils/index.mjs.map +1 -1
  22. package/dist/verifyConfig-CTrtqMr_.d.ts +94 -0
  23. package/dist/verifyConfig-Kn3Ikj00.d.mts +94 -0
  24. package/package.json +1 -16
  25. package/dist/configs/index.d.mts +0 -51
  26. package/dist/configs/index.d.ts +0 -51
  27. package/dist/configs/index.js +0 -38
  28. package/dist/configs/index.js.map +0 -1
  29. package/dist/configs/index.mjs +0 -11
  30. package/dist/configs/index.mjs.map +0 -1
  31. package/dist/plugin-BOb1Kw1A.d.ts +0 -47
  32. package/dist/plugin-DlsboiCF.d.mts +0 -47
  33. package/dist/plugins/index.d.mts +0 -85
  34. package/dist/plugins/index.d.ts +0 -85
  35. package/dist/plugins/index.js +0 -312
  36. package/dist/plugins/index.js.map +0 -1
  37. package/dist/plugins/index.mjs +0 -284
  38. package/dist/plugins/index.mjs.map +0 -1
  39. package/dist/transforms/index.d.mts +0 -38
  40. package/dist/transforms/index.d.ts +0 -38
  41. package/dist/transforms/index.js +0 -46
  42. package/dist/transforms/index.js.map +0 -1
  43. package/dist/transforms/index.mjs +0 -19
  44. package/dist/transforms/index.mjs.map +0 -1
  45. package/dist/types-DvJMYubf.d.mts +0 -151
  46. package/dist/types-DvJMYubf.d.ts +0 -151
@@ -1,284 +0,0 @@
1
- // src/plugins/uniqueRowConfig.ts
2
- import { ConvexError } from "convex/values";
3
-
4
- // src/core/types.ts
5
- function normalizeIndexConfigEntry(entry, defaultIdentifiers = ["_id"]) {
6
- if (typeof entry === "string") {
7
- return {
8
- index: entry,
9
- identifiers: defaultIdentifiers
10
- };
11
- }
12
- const { index, identifiers, ...rest } = entry;
13
- return {
14
- index: String(index),
15
- identifiers: identifiers?.map(String) ?? defaultIdentifiers,
16
- ...rest
17
- };
18
- }
19
-
20
- // src/utils/helpers.ts
21
- var getTableIndexes = (schema, tableName) => {
22
- return schema.tables[tableName][" indexes"]();
23
- };
24
- var constructColumnData = (fields, data, {
25
- allowNullishValue = false,
26
- allOrNothing = true
27
- }) => {
28
- const lengthOfFields = fields.length;
29
- const columnData = fields.map((_, index) => {
30
- const column = fields?.[index];
31
- const value = data?.[column];
32
- if (!column || !allowNullishValue && !value) {
33
- return;
34
- }
35
- return {
36
- column,
37
- value
38
- };
39
- }).filter((e) => !!e);
40
- if (allOrNothing && columnData.length !== lengthOfFields) {
41
- return null;
42
- }
43
- return columnData.length > 0 ? columnData : null;
44
- };
45
- var constructIndexData = (schema, tableName, indexConfig) => {
46
- if (!indexConfig) {
47
- return;
48
- }
49
- const tableConfig = indexConfig?.[tableName];
50
- if (!tableConfig) {
51
- return;
52
- }
53
- return tableConfig.map((entry) => {
54
- const normalized = normalizeIndexConfigEntry(entry);
55
- const { index, identifiers, ...rest } = normalized;
56
- const fields = getTableIndexes(schema, tableName).find(
57
- (i) => i.indexDescriptor == index
58
- )?.fields;
59
- if (!fields) {
60
- throw new Error(
61
- `Error in 'constructIndexData()'. No fields found for index: [${index}]`
62
- );
63
- }
64
- const identifierMap = new Map(
65
- [...identifiers, "_id"].map((i) => [String(i), String(i)])
66
- );
67
- return {
68
- name: index,
69
- fields,
70
- identifiers: Array.from(identifierMap.values()),
71
- ...rest
72
- };
73
- });
74
- };
75
-
76
- // src/plugins/uniqueRowConfig.ts
77
- var uniqueRowConfig = (schema, config) => {
78
- const uniqueRowError = (message) => {
79
- throw new ConvexError({
80
- message,
81
- code: "UNIQUE_ROW_VERIFICATION_ERROR"
82
- });
83
- };
84
- const verifyUniqueness = async (context, data, tableName) => {
85
- const { ctx, operation, patchId, onFail } = context;
86
- const indexesData = constructIndexData(schema, tableName, config);
87
- if (!indexesData && !!config[tableName]) {
88
- uniqueRowError(`Index data was not found where there should have been.`);
89
- }
90
- if (!indexesData) {
91
- return data;
92
- }
93
- for (const indexInfo of indexesData) {
94
- const { name, fields, identifiers, ...rest } = indexInfo;
95
- const _options = rest;
96
- if (!fields[0] && !fields[1]) {
97
- uniqueRowError(
98
- `Error in 'verifyRowUniqueness()'. There must be two columns to test against. If you are attempting to enforce a unique column, use the 'uniqueColumns' config option.`
99
- );
100
- }
101
- const columnData = constructColumnData(fields, data, {});
102
- const getExisting = async (cd) => {
103
- let existingByIndex = [];
104
- if (!cd) {
105
- existingByIndex = [];
106
- } else {
107
- existingByIndex = await ctx.db.query(tableName).withIndex(
108
- name,
109
- (q) => cd.reduce((query, { column, value }) => query.eq(column, value), q)
110
- ).collect();
111
- }
112
- if (existingByIndex.length > 1) {
113
- console.warn(
114
- `There was more than one existing result found for index ${name}. Check the following IDs:`,
115
- existingByIndex.map((r) => r._id)
116
- );
117
- console.warn(
118
- `It is recommended that you triage the rows listed above since they have data that go against a rule of row uniqueness.`
119
- );
120
- }
121
- return existingByIndex.length > 0 ? existingByIndex[0] : null;
122
- };
123
- const existing = await getExisting(columnData);
124
- if (operation === "insert") {
125
- if (!existing) {
126
- continue;
127
- }
128
- onFail?.({
129
- uniqueRow: {
130
- existingData: existing
131
- }
132
- });
133
- uniqueRowError(
134
- `Unable to [${operation}] document. In table [${tableName}], there is an existing row that has the same data combination in the columns: [${fields.join(`, `)}].`
135
- );
136
- }
137
- if (operation === "patch") {
138
- if (!patchId) {
139
- uniqueRowError(`Unable to patch document without an id.`);
140
- }
141
- const matchedToExisting = (_existing, _data) => {
142
- let idMatchedToExisting = null;
143
- if (_existing) {
144
- for (const identifier of identifiers) {
145
- if (_existing[identifier] !== void 0 && _data[identifier] !== void 0 && _existing[identifier] === _data[identifier] || identifier === "_id" && _existing[identifier] === patchId) {
146
- idMatchedToExisting = String(identifier);
147
- break;
148
- }
149
- }
150
- }
151
- return idMatchedToExisting;
152
- };
153
- const checkExisting = (_existing, _data) => {
154
- const matchedId = matchedToExisting(_existing, _data);
155
- if (!_existing) {
156
- return;
157
- }
158
- if (matchedId) {
159
- return;
160
- } else {
161
- onFail?.({
162
- uniqueRow: {
163
- existingData: _existing
164
- }
165
- });
166
- uniqueRowError(
167
- `In '${tableName}' table, there already exists a value match of the columns: [${fields.join(`,`)}].`
168
- );
169
- }
170
- };
171
- if (!existing && !columnData && patchId) {
172
- const match = await ctx.db.get(patchId);
173
- if (!match) {
174
- uniqueRowError(`No document found for id ${patchId}`);
175
- return data;
176
- }
177
- const extensiveColumnData = constructColumnData(
178
- fields,
179
- {
180
- ...match,
181
- ...data
182
- },
183
- {}
184
- );
185
- if (extensiveColumnData) {
186
- const extensiveExisting = await getExisting(extensiveColumnData);
187
- checkExisting(extensiveExisting, data);
188
- } else {
189
- uniqueRowError(`Incomplete data when there should have been enough.`);
190
- }
191
- } else {
192
- checkExisting(existing, data);
193
- }
194
- }
195
- }
196
- return data;
197
- };
198
- const extension = {
199
- _type: "uniqueRow",
200
- config,
201
- async verify(input) {
202
- return await verifyUniqueness(
203
- input,
204
- input.data,
205
- input.tableName
206
- );
207
- }
208
- };
209
- return extension;
210
- };
211
-
212
- // src/plugins/uniqueColumnConfig.ts
213
- import { ConvexError as ConvexError2 } from "convex/values";
214
- var uniqueColumnConfig = (_schema, config) => {
215
- const uniqueColumnError = (message) => {
216
- throw new ConvexError2({
217
- message,
218
- code: "UNIQUE_COLUMN_VERIFICATION_ERROR"
219
- });
220
- };
221
- const verifyUniqueness = async (context, data) => {
222
- const { ctx, tableName, patchId, onFail } = context;
223
- const tableConfig = config[tableName];
224
- if (!tableConfig) {
225
- return data;
226
- }
227
- for (const entry of tableConfig) {
228
- const { index, identifiers } = normalizeIndexConfigEntry(
229
- entry
230
- );
231
- const columnName = index.replace("by_", "");
232
- const value = data[columnName];
233
- if (value === void 0 || value === null) {
234
- continue;
235
- }
236
- const existing = await ctx.db.query(tableName).withIndex(index, (q) => q.eq(columnName, value)).unique();
237
- if (!existing) {
238
- continue;
239
- }
240
- let isOwnDocument = false;
241
- for (const identifier of identifiers) {
242
- if (identifier === "_id" && patchId && existing._id === patchId) {
243
- isOwnDocument = true;
244
- break;
245
- }
246
- const existingValue = existing[identifier];
247
- const incomingValue = data[identifier];
248
- if (existingValue !== void 0 && incomingValue !== void 0 && existingValue === incomingValue) {
249
- isOwnDocument = true;
250
- break;
251
- }
252
- }
253
- if (isOwnDocument) {
254
- continue;
255
- }
256
- onFail?.({
257
- uniqueColumn: {
258
- conflictingColumn: columnName,
259
- existingData: existing
260
- }
261
- });
262
- uniqueColumnError(
263
- `In [${tableName}] table, there already exists value "${value}" in column [${columnName}].`
264
- );
265
- }
266
- return data;
267
- };
268
- const extension = {
269
- _type: "uniqueColumn",
270
- config,
271
- async verify(input) {
272
- return await verifyUniqueness(
273
- input,
274
- input.data
275
- );
276
- }
277
- };
278
- return extension;
279
- };
280
- export {
281
- uniqueColumnConfig,
282
- uniqueRowConfig
283
- };
284
- //# sourceMappingURL=index.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/plugins/uniqueRowConfig.ts","../../src/core/types.ts","../../src/utils/helpers.ts","../../src/plugins/uniqueColumnConfig.ts"],"sourcesContent":["import {\n\tDataModelFromSchemaDefinition,\n\tDocumentByName,\n\tGenericSchema,\n\tSchemaDefinition,\n\tTableNamesInDataModel,\n} from 'convex/server';\nimport { ConvexError } from 'convex/values';\n\nimport { ExtensionContext, SchemaExtension } from '../core/plugin';\nimport { UniqueRowConfigData, UniqueRowConfigOptions } from '../core/types';\nimport { constructColumnData, constructIndexData } from '../utils/helpers';\n\n/**\n * Creates an extension that enforces row uniqueness based on database indexes.\n *\n * This extension checks that the combination of column values defined in your indexes\n * doesn't already exist in the database before allowing insert/patch operations.\n *\n * @param schema - Your Convex schema definition\n * @param config - Object mapping table names to arrays of index configs\n * @returns An extension for use with verifyConfig\n *\n * @example\n * ```ts\n * // Simple shorthand - just index names\n * const uniqueRow = uniqueRowConfig(schema, {\n * posts: ['by_slug'],\n * users: ['by_email', 'by_username'],\n * });\n *\n * // With options\n * const uniqueRow = uniqueRowConfig(schema, {\n * posts: [\n * { index: 'by_author_slug', identifiers: ['_id', 'authorId'] },\n * ],\n * });\n *\n * // Use with verifyConfig\n * const { insert, patch } = verifyConfig(schema, {\n * extensions: [uniqueRow],\n * });\n * ```\n */\nexport const uniqueRowConfig = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tconst C extends UniqueRowConfigData<DataModel>,\n>(\n\tschema: S,\n\tconfig: C\n): SchemaExtension<S, 'uniqueRow', C> => {\n\tconst uniqueRowError = (message: string): never => {\n\t\tthrow new ConvexError({\n\t\t\tmessage,\n\t\t\tcode: 'UNIQUE_ROW_VERIFICATION_ERROR',\n\t\t});\n\t};\n\n\t/**\n\t * Core verification logic shared between insert and patch\n\t */\n\tconst verifyUniqueness = async <\n\t\tTN extends TableNamesInDataModel<DataModel>,\n\t\tD extends Record<string, any>,\n\t>(\n\t\tcontext: ExtensionContext<TN>,\n\t\tdata: D,\n\t\ttableName: TN\n\t): Promise<D> => {\n\t\tconst { ctx, operation, patchId, onFail } = context;\n\n\t\tconst indexesData = constructIndexData(schema, tableName, config);\n\n\t\tif (!indexesData && !!config[tableName]) {\n\t\t\tuniqueRowError(`Index data was not found where there should have been.`);\n\t\t}\n\n\t\t// No indexes provided for this table\n\t\tif (!indexesData) {\n\t\t\treturn data;\n\t\t}\n\n\t\tfor (const indexInfo of indexesData) {\n\t\t\tconst { name, fields, identifiers, ...rest } = indexInfo;\n\t\t\tconst _options = rest as UniqueRowConfigOptions;\n\n\t\t\tif (!fields[0] && !fields[1]) {\n\t\t\t\tuniqueRowError(\n\t\t\t\t\t`Error in 'verifyRowUniqueness()'. There must be two columns to test against. If you are attempting to enforce a unique column, use the 'uniqueColumns' config option.`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\tconst columnData = constructColumnData(fields, data, {});\n\n\t\t\tconst getExisting = async (cd: ReturnType<typeof constructColumnData>) => {\n\t\t\t\ttype D = DocumentByName<DataModel, TN>;\n\t\t\t\tlet existingByIndex: D[] = [];\n\n\t\t\t\tif (!cd) {\n\t\t\t\t\texistingByIndex = [];\n\t\t\t\t} else {\n\t\t\t\t\texistingByIndex = await ctx.db\n\t\t\t\t\t\t.query(tableName)\n\t\t\t\t\t\t.withIndex(name, (q: any) =>\n\t\t\t\t\t\t\tcd.reduce((query: any, { column, value }) => query.eq(column, value), q)\n\t\t\t\t\t\t)\n\t\t\t\t\t\t.collect();\n\t\t\t\t}\n\n\t\t\t\tif (existingByIndex.length > 1) {\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`There was more than one existing result found for index ${name}. Check the following IDs:`,\n\t\t\t\t\t\texistingByIndex.map((r) => r._id)\n\t\t\t\t\t);\n\t\t\t\t\tconsole.warn(\n\t\t\t\t\t\t`It is recommended that you triage the rows listed above since they have data that go against a rule of row uniqueness.`\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn existingByIndex.length > 0 ? existingByIndex[0] : null;\n\t\t\t};\n\n\t\t\tconst existing = await getExisting(columnData);\n\n\t\t\t/**\n\t\t\t * Insert check\n\t\t\t */\n\t\t\tif (operation === 'insert') {\n\t\t\t\tif (!existing) {\n\t\t\t\t\t// All good, verify passes for this index, continue to next\n\t\t\t\t\tcontinue;\n\t\t\t\t}\n\n\t\t\t\t// Found existing - fail\n\t\t\t\tonFail?.({\n\t\t\t\t\tuniqueRow: {\n\t\t\t\t\t\texistingData: existing,\n\t\t\t\t\t},\n\t\t\t\t});\n\t\t\t\tuniqueRowError(\n\t\t\t\t\t`Unable to [${operation}] document. In table [${tableName}], there is an existing row that has the same data combination in the columns: [${fields.join(`, `)}].`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Patch check\n\t\t\t */\n\t\t\tif (operation === 'patch') {\n\t\t\t\tif (!patchId) {\n\t\t\t\t\tuniqueRowError(`Unable to patch document without an id.`);\n\t\t\t\t}\n\n\t\t\t\ttype D = DocumentByName<DataModel, TN>;\n\n\t\t\t\t/**\n\t\t\t\t * Check if the existing document matches one of the identifiers\n\t\t\t\t * (meaning we're updating the same document, not creating a conflict)\n\t\t\t\t */\n\t\t\t\tconst matchedToExisting = (_existing: D | null, _data: Partial<D>) => {\n\t\t\t\t\tlet idMatchedToExisting: string | null = null;\n\n\t\t\t\t\tif (_existing) {\n\t\t\t\t\t\tfor (const identifier of identifiers) {\n\t\t\t\t\t\t\t\tif (\n\t\t\t\t\t\t\t\t\t((_existing[identifier as keyof D] !== undefined &&\n\t\t\t\t\t\t\t\t\t\t_data[identifier as keyof D] !== undefined &&\n\t\t\t\t\t\t\t\t\t\t_existing[identifier as keyof D] === _data[identifier as keyof D]) ||\n\t\t\t\t\t\t\t\t\t\t(identifier === '_id' && _existing[identifier as keyof D] === patchId))\n\t\t\t\t\t\t\t\t) {\n\t\t\t\t\t\t\t\tidMatchedToExisting = String(identifier);\n\t\t\t\t\t\t\t\tbreak;\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t}\n\t\t\t\t\t}\n\t\t\t\t\treturn idMatchedToExisting;\n\t\t\t\t};\n\n\t\t\t\tconst checkExisting = (_existing: D | null, _data: Partial<D>) => {\n\t\t\t\t\tconst matchedId = matchedToExisting(_existing, _data);\n\n\t\t\t\t\tif (!_existing) {\n\t\t\t\t\t\t// No existing found, no conflict\n\t\t\t\t\t\treturn;\n\t\t\t\t\t}\n\n\t\t\t\t\tif (matchedId) {\n\t\t\t\t\t\t// The existing document is the same one we're patching - OK\n\t\t\t\t\t\treturn;\n\t\t\t\t\t} else {\n\t\t\t\t\t\t// Found a different document with the same unique values - fail\n\t\t\t\t\t\tonFail?.({\n\t\t\t\t\t\t\tuniqueRow: {\n\t\t\t\t\t\t\t\texistingData: _existing,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t});\n\t\t\t\t\t\tuniqueRowError(\n\t\t\t\t\t\t\t`In '${tableName}' table, there already exists a value match of the columns: [${fields.join(`,`)}].`\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t};\n\n\t\t\t\tif (!existing && !columnData && patchId) {\n\t\t\t\t\t// No existing results found because there wasn't complete data provided\n\t\t\t\t\t// to match the provided index. We need to merge with existing document\n\t\t\t\t\t// to check what WOULD be the potential data conflict.\n\t\t\t\t\tconst match = await ctx.db.get(patchId);\n\n\t\t\t\t\tif (!match) {\n\t\t\t\t\t\tuniqueRowError(`No document found for id ${patchId}`);\n\t\t\t\t\t\treturn data; // TypeScript needs this even though we throw\n\t\t\t\t\t}\n\n\t\t\t\t\tconst extensiveColumnData = constructColumnData(\n\t\t\t\t\t\tfields,\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\t...match,\n\t\t\t\t\t\t\t...data,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t{}\n\t\t\t\t\t);\n\n\t\t\t\t\tif (extensiveColumnData) {\n\t\t\t\t\t\tconst extensiveExisting = await getExisting(extensiveColumnData);\n\t\t\t\t\t\tcheckExisting(extensiveExisting as D | null, data as Partial<D>);\n\t\t\t\t\t} else {\n\t\t\t\t\t\tuniqueRowError(`Incomplete data when there should have been enough.`);\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\tcheckExisting(existing as D | null, data as Partial<D>);\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\n\t\treturn data;\n\t};\n\n\tconst extension = {\n\t\t_type: 'uniqueRow',\n\t\tconfig,\n\t\tasync verify(input) {\n\t\t\treturn (await verifyUniqueness(\n\t\t\t\tinput as unknown as ExtensionContext<TableNamesInDataModel<DataModel>>,\n\t\t\t\tinput.data as Record<string, any>,\n\t\t\t\tinput.tableName as TableNamesInDataModel<DataModel>\n\t\t\t)) as typeof input.data;\n\t\t},\n\t} as SchemaExtension<S, 'uniqueRow', C>;\n\n\treturn extension;\n};\n","import {\n\tDataModelFromSchemaDefinition,\n\tGenericDocument,\n\tIndexes,\n\tNamedTableInfo,\n\tSchemaDefinition,\n\tWithoutSystemFields,\n} from 'convex/server';\n\n// =============================================================================\n// Utility Types\n// =============================================================================\n\nexport type Prettify<T> = { [K in keyof T]: T[K] } & {};\n\nexport type MakeOptional<T, K extends PropertyKey> = Prettify<\n\tOmit<T, K & keyof T> & Partial<Pick<T, K & keyof T>>\n>;\n\n// =============================================================================\n// Base Types for Config Functions\n// =============================================================================\n\n/**\n * Base interface that all config functions should return.\n * Each config type can have its own `verify` signature and additional properties.\n */\nexport type BaseConfigReturn = {\n\tconfig: Record<string, any>;\n};\n\n// =============================================================================\n// OnFail Types\n// =============================================================================\n\nexport type OnFailArgs<D extends GenericDocument> = {\n\tuniqueColumn?: {\n\t\tconflictingColumn: keyof D;\n\t\texistingData: D;\n\t};\n\tuniqueRow?: {\n\t\texistingData: D | null;\n\t};\n\teditableColumn?: {\n\t\tremovedColumns: string[];\n\t\tfilteredData: Partial<WithoutSystemFields<D>>;\n\t};\n\trequiredColumn?: {\n\t\tmissingColumn: keyof D;\n\t};\n};\n\nexport type OnFailCallback<D extends GenericDocument> = (args: OnFailArgs<D>) => void;\n\n// =============================================================================\n// Config Data Types (what the user provides)\n// =============================================================================\n\nexport type DMGeneric = DataModelFromSchemaDefinition<SchemaDefinition<any, boolean>>;\n\nexport type DefaultValuesConfigData<DM extends DMGeneric> = {\n\t[K in keyof DM]?: {\n\t\t[column in keyof WithoutSystemFields<DM[K]['document']>]?: DM[K]['document'][column];\n\t};\n};\n\n// =============================================================================\n// Index-Based Config Types (shared between uniqueRow, uniqueColumn, etc.)\n// =============================================================================\n\n/**\n * Base options shared by all index-based config entries.\n * Individual extensions can extend this with their own options.\n */\nexport type IndexConfigBaseOptions = {\n\t/** Additional identifiers to check if the existing row is the same document being updated */\n\tidentifiers?: string[];\n};\n\n/**\n * A config entry that can be either:\n * - A string (index name) for shorthand\n * - An object with `index` and additional options\n *\n * @example\n * ```ts\n * // These are equivalent:\n * 'by_username'\n * { index: 'by_username' }\n *\n * // With options:\n * { index: 'by_username', identifiers: ['_id', 'userId'] }\n * ```\n */\nexport type IndexConfigEntry<\n\tDM extends DMGeneric,\n\tK extends keyof DM,\n\tOptions extends IndexConfigBaseOptions = IndexConfigBaseOptions,\n> =\n\t| keyof Indexes<NamedTableInfo<DM, K>>\n\t| ({\n\t\t\tindex: keyof Indexes<NamedTableInfo<DM, K>>;\n\t\t\tidentifiers?: (keyof NamedTableInfo<DM, K>['document'])[];\n\t } & Omit<Options, 'identifiers'>);\n\n/**\n * Normalized form of an index config entry (always an object)\n */\nexport type NormalizedIndexConfig<Options extends IndexConfigBaseOptions = IndexConfigBaseOptions> =\n\t{\n\t\tindex: string;\n\t\tidentifiers: string[];\n\t} & Omit<Options, 'identifiers'>;\n\n/**\n * Normalize a config entry to always have index and identifiers.\n * Works for both string shorthand and full object configs.\n */\nexport function normalizeIndexConfigEntry<\n\tOptions extends IndexConfigBaseOptions = IndexConfigBaseOptions,\n>(\n\tentry: string | ({ index: string; identifiers?: string[] } & Omit<Options, 'identifiers'>),\n\tdefaultIdentifiers: string[] = ['_id']\n): NormalizedIndexConfig<Options> {\n\tif (typeof entry === 'string') {\n\t\treturn {\n\t\t\tindex: entry,\n\t\t\tidentifiers: defaultIdentifiers,\n\t\t} as NormalizedIndexConfig<Options>;\n\t}\n\n\tconst { index, identifiers, ...rest } = entry;\n\treturn {\n\t\tindex: String(index),\n\t\tidentifiers: identifiers?.map(String) ?? defaultIdentifiers,\n\t\t...rest,\n\t} as NormalizedIndexConfig<Options>;\n}\n\n// =============================================================================\n// UniqueRow Config Types\n// =============================================================================\n\nexport type UniqueRowConfigOptions = IndexConfigBaseOptions & {\n\tqueryExistingWithNullish?: boolean;\n};\n\nexport type UniqueRowConfigEntry<DM extends DMGeneric, K extends keyof DM> = IndexConfigEntry<\n\tDM,\n\tK,\n\tUniqueRowConfigOptions\n>;\n\nexport type UniqueRowConfigData<DM extends DMGeneric> = {\n\t[K in keyof DM]?: UniqueRowConfigEntry<DM, K>[];\n};\n\n// =============================================================================\n// UniqueColumn Config Types\n// =============================================================================\n\nexport type UniqueColumnConfigOptions = IndexConfigBaseOptions;\n\nexport type UniqueColumnConfigEntry<DM extends DMGeneric, K extends keyof DM> = IndexConfigEntry<\n\tDM,\n\tK,\n\tUniqueColumnConfigOptions\n>;\n\nexport type UniqueColumnConfigData<DM extends DMGeneric> = {\n\t[K in keyof DM]?: UniqueColumnConfigEntry<DM, K>[];\n};\n\n// =============================================================================\n// Input Types (loose types for verifyConfig to accept)\n// =============================================================================\n\n/**\n * Loose input types that accept any return from config functions.\n * We use loose types here to avoid complex generic matching,\n * then extract the specific config types using conditional types.\n */\nexport type DefaultValuesInput = {\n\t_type: 'defaultValues';\n\tverify: (tableName: any, data: any) => Promise<any>;\n\tconfig:\n\t\t| Record<string, Record<string, any>>\n\t\t| (() => Record<string, Record<string, any>> | Promise<Record<string, Record<string, any>>>);\n};\n\n/**\n * Loose input type for protectedColumnsConfig return value.\n */\nexport type ProtectedColumnsInput = {\n\t_type: 'protectedColumns';\n\tconfig: Record<string, string[]>;\n};\n\n// =============================================================================\n// Object-Based Types (for verifyConfig)\n// =============================================================================\n\n/**\n * Config input for verifyConfig.\n *\n * - `defaultValues`: Transform config that makes fields optional (affects types)\n * - `protectedColumns`: Columns that cannot be patched (affects patch() types)\n * Extension-specific options are added by `verifyConfig`.\n */\nexport type VerifyConfigInput = {\n\tdefaultValues?: DefaultValuesInput;\n\tprotectedColumns?: ProtectedColumnsInput;\n};\n\n// =============================================================================\n// Type Extraction Helpers\n// =============================================================================\n\n/**\n * Extract the config type from defaultValues.config.\n * Handles both direct object and function forms.\n */\nexport type ExtractDefaultValuesConfig<VC> = VC extends {\n\tdefaultValues: { config: infer C };\n}\n\t? C extends () => infer R\n\t\t? Awaited<R>\n\t\t: C\n\t: Record<string, never>;\n\n/**\n * Compute which keys should be optional for a given table based on all configs.\n * Currently only defaultValues affects optionality.\n */\nexport type OptionalKeysForTable<VC, TN> = TN extends keyof ExtractDefaultValuesConfig<VC>\n\t? keyof ExtractDefaultValuesConfig<VC>[TN]\n\t: never;\n\n/**\n * Helper to check if a key exists in a type\n */\nexport type HasKey<T, K extends PropertyKey> = K extends keyof T ? true : false;\n\n// =============================================================================\n// Protected Columns Type Extraction\n// =============================================================================\n\n/**\n * Extract the config type from protectedColumns.config\n */\nexport type ExtractProtectedColumnsConfig<VC> = VC extends {\n\tprotectedColumns: { config: infer C };\n}\n\t? C\n\t: Record<string, never>;\n\n/**\n * Get protected column keys for a specific table.\n * Returns the column names that should be omitted from patch() input.\n */\nexport type ProtectedKeysForTable<VC, TN> = TN extends keyof ExtractProtectedColumnsConfig<VC>\n\t? ExtractProtectedColumnsConfig<VC>[TN] extends readonly (infer K)[]\n\t\t? K\n\t\t: never\n\t: never;\n","import {\n\tDataModelFromSchemaDefinition,\n\tDocumentByName,\n\tGenericSchema,\n\tSchemaDefinition,\n\tTableNamesInDataModel,\n} from \"convex/server\";\n\nimport {\n\tIndexConfigBaseOptions,\n\tNormalizedIndexConfig,\n\tnormalizeIndexConfigEntry,\n\tUniqueRowConfigData,\n} from \"../core/types\";\n\n/**\n * Get Table indexes helper\n *\n * Note: this is using an experimental API in convex-js\n * https://github.com/get-convex/convex-js/commit/04c3b44cab54c4d2230cce9312bdff074d54ab04\n */\nexport const getTableIndexes = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tTN extends TableNamesInDataModel<DataModel>,\n>(\n\tschema: S,\n\ttableName: TN,\n) => {\n\treturn schema.tables[tableName][\" indexes\"]();\n};\n\n/**\n * Generate column data from fields and data object\n */\nexport const constructColumnData = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tTN extends TableNamesInDataModel<DataModel>,\n\tD extends Partial<DocumentByName<DataModel, TN>>,\n>(\n\tfields: string[],\n\tdata: D,\n\t{\n\t\tallowNullishValue = false,\n\t\tallOrNothing = true,\n\t}: {\n\t\tallowNullishValue?: boolean;\n\t\tallOrNothing?: boolean;\n\t},\n) => {\n\tconst lengthOfFields = fields.length;\n\n\tconst columnData = fields\n\t\t.map((_, index) => {\n\t\t\tconst column = fields?.[index];\n\t\t\tconst value = data?.[column];\n\n\t\t\tif (!column || (!allowNullishValue && !value)) {\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\treturn {\n\t\t\t\tcolumn,\n\t\t\t\tvalue,\n\t\t\t};\n\t\t})\n\t\t.filter((e) => !!e);\n\n\tif (allOrNothing && columnData.length !== lengthOfFields) {\n\t\treturn null;\n\t}\n\n\treturn columnData.length > 0 ? columnData : null;\n};\n\n/**\n * Construct index data from schema and config.\n * Handles both string shorthand and full object config entries.\n *\n * @returns Array of normalized index configs with resolved field names from schema\n */\nexport const constructIndexData = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tTN extends TableNamesInDataModel<DataModel>,\n\tOptions extends IndexConfigBaseOptions = IndexConfigBaseOptions,\n>(\n\tschema: S,\n\ttableName: TN,\n\tindexConfig?: UniqueRowConfigData<DataModel>,\n):\n\t| (NormalizedIndexConfig<Options> & { name: string; fields: string[] })[]\n\t| undefined => {\n\tif (!indexConfig) {\n\t\treturn;\n\t}\n\n\tconst tableConfig = indexConfig?.[tableName];\n\tif (!tableConfig) {\n\t\treturn;\n\t}\n\n\treturn tableConfig.map((entry) => {\n\t\t// Normalize the entry (handles both string and object forms)\n\t\tconst normalized = normalizeIndexConfigEntry<Options>(entry as any);\n\t\tconst { index, identifiers, ...rest } = normalized;\n\n\t\tconst fields = getTableIndexes(schema, tableName).find(\n\t\t\t(i) => i.indexDescriptor == index,\n\t\t)?.fields;\n\n\t\tif (!fields) {\n\t\t\tthrow new Error(\n\t\t\t\t`Error in 'constructIndexData()'. No fields found for index: [${index}]`,\n\t\t\t);\n\t\t}\n\n\t\t// Create a unique map in case there is any overlap in identifiers\n\t\t// Always include '_id' as a fallback identifier\n\t\tconst identifierMap = new Map<string, string>(\n\t\t\t[...identifiers, \"_id\"].map((i) => [String(i), String(i)]),\n\t\t);\n\n\t\treturn {\n\t\t\tname: index,\n\t\t\tfields,\n\t\t\tidentifiers: Array.from(identifierMap.values()),\n\t\t\t...rest,\n\t\t} as NormalizedIndexConfig<Options> & { name: string; fields: string[] };\n\t});\n};\n","import { DataModelFromSchemaDefinition, GenericSchema, SchemaDefinition } from 'convex/server';\nimport { ConvexError } from 'convex/values';\n\nimport { ExtensionContext, SchemaExtension } from '../core/plugin';\nimport {\n\tnormalizeIndexConfigEntry,\n\tUniqueColumnConfigData,\n\tUniqueColumnConfigOptions,\n} from '../core/types';\n\n/**\n * Creates an extension that enforces column uniqueness using single-column indexes.\n *\n * This is useful when you have a column that must be unique across all rows,\n * like usernames or email addresses.\n *\n * The column name is derived from the index name by removing the 'by_' prefix.\n * For example, 'by_username' checks the 'username' column.\n *\n * @param schema - Your Convex schema definition\n * @param config - Object mapping table names to arrays of index configs\n * @returns An extension for use with verifyConfig\n *\n * @example\n * ```ts\n * // Shorthand: just pass index names as strings\n * const uniqueColumn = uniqueColumnConfig(schema, {\n * users: ['by_username', 'by_email'],\n * organizations: ['by_slug'],\n * });\n *\n * // Full config: pass objects with options\n * const uniqueColumn = uniqueColumnConfig(schema, {\n * users: [\n * { index: 'by_username', identifiers: ['_id', 'userId'] },\n * { index: 'by_email', identifiers: ['_id'] },\n * ],\n * });\n *\n * // Mix and match\n * const uniqueColumn = uniqueColumnConfig(schema, {\n * users: [\n * 'by_username', // shorthand\n * { index: 'by_email', identifiers: ['_id', 'clerkId'] }, // full config\n * ],\n * });\n *\n * // Use with verifyConfig\n * const { insert, patch } = verifyConfig(schema, {\n * extensions: [uniqueColumn],\n * });\n * ```\n */\nexport const uniqueColumnConfig = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tconst C extends UniqueColumnConfigData<DataModel>,\n>(\n\t_schema: S,\n\tconfig: C\n): SchemaExtension<S, 'uniqueColumn', C> => {\n\tconst uniqueColumnError = (message: string): never => {\n\t\tthrow new ConvexError({\n\t\t\tmessage,\n\t\t\tcode: 'UNIQUE_COLUMN_VERIFICATION_ERROR',\n\t\t});\n\t};\n\n\t/**\n\t * Core verification logic shared between insert and patch\n\t */\n\tconst verifyUniqueness = async <TN extends string, D extends Record<string, any>>(\n\t\tcontext: ExtensionContext<TN>,\n\t\tdata: D\n\t): Promise<D> => {\n\t\tconst { ctx, tableName, patchId, onFail } = context;\n\n\t\tconst tableConfig = config[tableName as keyof typeof config] as\n\t\t\t| (string | { index: string; identifiers?: string[] })[]\n\t\t\t| undefined;\n\n\t\t// No config for this table\n\t\tif (!tableConfig) {\n\t\t\treturn data;\n\t\t}\n\n\t\tfor (const entry of tableConfig) {\n\t\t\tconst { index, identifiers } = normalizeIndexConfigEntry<UniqueColumnConfigOptions>(\n\t\t\t\tentry as any\n\t\t\t);\n\n\t\t\t// Extract column name from index name (e.g., 'by_username' -> 'username')\n\t\t\tconst columnName = index.replace('by_', '');\n\t\t\tconst value = data[columnName];\n\n\t\t\t// Skip if the column isn't in the data being inserted/patched\n\t\t\tif (value === undefined || value === null) {\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Query for existing row with this value\n\t\t\tconst existing = await ctx.db\n\t\t\t\t.query(tableName)\n\t\t\t\t.withIndex(index, (q: any) => q.eq(columnName, value))\n\t\t\t\t.unique();\n\n\t\t\tif (!existing) {\n\t\t\t\t// No conflict, continue to next index\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Check if the existing row matches one of the identifiers\n\t\t\t// (meaning we're updating the same document, not creating a conflict)\n\t\t\tlet isOwnDocument = false;\n\n\t\t\tfor (const identifier of identifiers) {\n\t\t\t\t// For patch operations, also check against patchId when identifier is '_id'\n\t\t\t\tif (identifier === '_id' && patchId && existing._id === patchId) {\n\t\t\t\t\tisOwnDocument = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\n\t\t\t\t// Check if both existing and data have the same identifier value\n\t\t\t\tconst existingValue = existing[identifier];\n\t\t\t\tconst incomingValue = data[identifier];\n\n\t\t\t\tif (\n\t\t\t\t\texistingValue !== undefined &&\n\t\t\t\t\tincomingValue !== undefined &&\n\t\t\t\t\texistingValue === incomingValue\n\t\t\t\t) {\n\t\t\t\t\tisOwnDocument = true;\n\t\t\t\t\tbreak;\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (isOwnDocument) {\n\t\t\t\t// Same document, no conflict\n\t\t\t\tcontinue;\n\t\t\t}\n\n\t\t\t// Different document has this value - fail\n\t\t\tonFail?.({\n\t\t\t\tuniqueColumn: {\n\t\t\t\t\tconflictingColumn: columnName,\n\t\t\t\t\texistingData: existing,\n\t\t\t\t},\n\t\t\t});\n\n\t\t\tuniqueColumnError(\n\t\t\t\t`In [${tableName}] table, there already exists value \"${value}\" in column [${columnName}].`\n\t\t\t);\n\t\t}\n\n\t\treturn data;\n\t};\n\n\tconst extension = {\n\t\t_type: 'uniqueColumn',\n\t\tconfig,\n\t\tasync verify(input) {\n\t\t\treturn (await verifyUniqueness(\n\t\t\t\tinput as unknown as ExtensionContext<typeof input.tableName>,\n\t\t\t\tinput.data as Record<string, any>\n\t\t\t)) as typeof input.data;\n\t\t},\n\t} as SchemaExtension<S, 'uniqueColumn', C>;\n\n\treturn extension;\n};\n"],"mappings":"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","names":["ConvexError","ConvexError"]}
@@ -1,38 +0,0 @@
1
- import { SchemaDefinition, GenericSchema, DataModelFromSchemaDefinition, TableNamesInDataModel, WithoutSystemFields, DocumentByName } from 'convex/server';
2
- import { D as DefaultValuesConfigData, M as MakeOptional } from '../types-DvJMYubf.mjs';
3
-
4
- /**
5
- * Creates a default values transform.
6
- *
7
- * Makes specified fields optional in insert() by providing default values.
8
- * Supports both static config objects and dynamic functions (sync or async).
9
- *
10
- * @param schema - Your Convex schema definition
11
- * @param config - Default values config (object or function returning object)
12
- * @returns Config object for use with verifyConfig
13
- *
14
- * @example
15
- * ```ts
16
- * // Static config (same values reused)
17
- * const defaults = defaultValuesConfig(schema, {
18
- * posts: { status: 'draft', views: 0 },
19
- * });
20
- *
21
- * // Dynamic config (fresh values on each insert)
22
- * const defaults = defaultValuesConfig(schema, () => ({
23
- * posts: { status: 'draft', slug: generateRandomSlug() },
24
- * }));
25
- *
26
- * // Async config
27
- * const defaults = defaultValuesConfig(schema, async () => ({
28
- * posts: { category: await fetchDefaultCategory() },
29
- * }));
30
- * ```
31
- */
32
- declare const defaultValuesConfig: <S extends SchemaDefinition<GenericSchema, boolean>, DataModel extends DataModelFromSchemaDefinition<S>, const C extends DefaultValuesConfigData<DataModel>>(_schema: S, config: C | (() => C | Promise<C>)) => {
33
- _type: "defaultValues";
34
- verify: <TN extends TableNamesInDataModel<DataModel>>(tableName: TN, data: MakeOptional<WithoutSystemFields<DocumentByName<DataModel, TN>>, keyof C[TN]>) => Promise<WithoutSystemFields<DocumentByName<DataModel, TN>>>;
35
- config: C | (() => C | Promise<C>);
36
- };
37
-
38
- export { DefaultValuesConfigData, defaultValuesConfig };
@@ -1,38 +0,0 @@
1
- import { SchemaDefinition, GenericSchema, DataModelFromSchemaDefinition, TableNamesInDataModel, WithoutSystemFields, DocumentByName } from 'convex/server';
2
- import { D as DefaultValuesConfigData, M as MakeOptional } from '../types-DvJMYubf.js';
3
-
4
- /**
5
- * Creates a default values transform.
6
- *
7
- * Makes specified fields optional in insert() by providing default values.
8
- * Supports both static config objects and dynamic functions (sync or async).
9
- *
10
- * @param schema - Your Convex schema definition
11
- * @param config - Default values config (object or function returning object)
12
- * @returns Config object for use with verifyConfig
13
- *
14
- * @example
15
- * ```ts
16
- * // Static config (same values reused)
17
- * const defaults = defaultValuesConfig(schema, {
18
- * posts: { status: 'draft', views: 0 },
19
- * });
20
- *
21
- * // Dynamic config (fresh values on each insert)
22
- * const defaults = defaultValuesConfig(schema, () => ({
23
- * posts: { status: 'draft', slug: generateRandomSlug() },
24
- * }));
25
- *
26
- * // Async config
27
- * const defaults = defaultValuesConfig(schema, async () => ({
28
- * posts: { category: await fetchDefaultCategory() },
29
- * }));
30
- * ```
31
- */
32
- declare const defaultValuesConfig: <S extends SchemaDefinition<GenericSchema, boolean>, DataModel extends DataModelFromSchemaDefinition<S>, const C extends DefaultValuesConfigData<DataModel>>(_schema: S, config: C | (() => C | Promise<C>)) => {
33
- _type: "defaultValues";
34
- verify: <TN extends TableNamesInDataModel<DataModel>>(tableName: TN, data: MakeOptional<WithoutSystemFields<DocumentByName<DataModel, TN>>, keyof C[TN]>) => Promise<WithoutSystemFields<DocumentByName<DataModel, TN>>>;
35
- config: C | (() => C | Promise<C>);
36
- };
37
-
38
- export { DefaultValuesConfigData, defaultValuesConfig };
@@ -1,46 +0,0 @@
1
- "use strict";
2
- var __defProp = Object.defineProperty;
3
- var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
4
- var __getOwnPropNames = Object.getOwnPropertyNames;
5
- var __hasOwnProp = Object.prototype.hasOwnProperty;
6
- var __export = (target, all) => {
7
- for (var name in all)
8
- __defProp(target, name, { get: all[name], enumerable: true });
9
- };
10
- var __copyProps = (to, from, except, desc) => {
11
- if (from && typeof from === "object" || typeof from === "function") {
12
- for (let key of __getOwnPropNames(from))
13
- if (!__hasOwnProp.call(to, key) && key !== except)
14
- __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
15
- }
16
- return to;
17
- };
18
- var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
19
-
20
- // src/transforms/index.ts
21
- var transforms_exports = {};
22
- __export(transforms_exports, {
23
- defaultValuesConfig: () => defaultValuesConfig
24
- });
25
- module.exports = __toCommonJS(transforms_exports);
26
-
27
- // src/transforms/defaultValuesConfig.ts
28
- var defaultValuesConfig = (_schema, config) => {
29
- const verify = async (tableName, data) => {
30
- const resolvedConfig = typeof config === "function" ? await config() : config;
31
- return {
32
- ...resolvedConfig[tableName],
33
- ...data
34
- };
35
- };
36
- return {
37
- _type: "defaultValues",
38
- verify,
39
- config
40
- };
41
- };
42
- // Annotate the CommonJS export names for ESM import in node:
43
- 0 && (module.exports = {
44
- defaultValuesConfig
45
- });
46
- //# sourceMappingURL=index.js.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/transforms/index.ts","../../src/transforms/defaultValuesConfig.ts"],"sourcesContent":["export { defaultValuesConfig } from './defaultValuesConfig';\n\n// Re-export the type from core for convenience\nexport type { DefaultValuesConfigData } from '../core/types';\n","import {\n\tDataModelFromSchemaDefinition,\n\tDocumentByName,\n\tGenericSchema,\n\tSchemaDefinition,\n\tTableNamesInDataModel,\n\tWithoutSystemFields,\n} from \"convex/server\";\n\nimport { DefaultValuesConfigData, MakeOptional } from \"../core/types\";\n\n/**\n * Creates a default values transform.\n *\n * Makes specified fields optional in insert() by providing default values.\n * Supports both static config objects and dynamic functions (sync or async).\n *\n * @param schema - Your Convex schema definition\n * @param config - Default values config (object or function returning object)\n * @returns Config object for use with verifyConfig\n *\n * @example\n * ```ts\n * // Static config (same values reused)\n * const defaults = defaultValuesConfig(schema, {\n * posts: { status: 'draft', views: 0 },\n * });\n *\n * // Dynamic config (fresh values on each insert)\n * const defaults = defaultValuesConfig(schema, () => ({\n * posts: { status: 'draft', slug: generateRandomSlug() },\n * }));\n *\n * // Async config\n * const defaults = defaultValuesConfig(schema, async () => ({\n * posts: { category: await fetchDefaultCategory() },\n * }));\n * ```\n */\nexport const defaultValuesConfig = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tconst C extends DefaultValuesConfigData<DataModel>,\n>(\n\t_schema: S,\n\tconfig: C | (() => C | Promise<C>),\n) => {\n\t/**\n\t * Apply default values to the data for a given table.\n\t * Async to support dynamic config functions.\n\t */\n\tconst verify = async <TN extends TableNamesInDataModel<DataModel>>(\n\t\ttableName: TN,\n\t\tdata: MakeOptional<\n\t\t\tWithoutSystemFields<DocumentByName<DataModel, TN>>,\n\t\t\tkeyof C[TN]\n\t\t>,\n\t): Promise<WithoutSystemFields<DocumentByName<DataModel, TN>>> => {\n\t\t// Resolve config - handle both direct object and function forms\n\t\tconst resolvedConfig =\n\t\t\ttypeof config === \"function\" ? await config() : config;\n\n\t\treturn {\n\t\t\t...(resolvedConfig[tableName] as Partial<\n\t\t\t\tWithoutSystemFields<DocumentByName<DataModel, TN>>\n\t\t\t>),\n\t\t\t...(data as WithoutSystemFields<DocumentByName<DataModel, TN>>),\n\t\t};\n\t};\n\n\treturn {\n\t\t_type: \"defaultValues\" as const,\n\t\tverify,\n\t\tconfig,\n\t};\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACuCO,IAAM,sBAAsB,CAKlC,SACA,WACI;AAKJ,QAAM,SAAS,OACd,WACA,SAIiE;AAEjE,UAAM,iBACL,OAAO,WAAW,aAAa,MAAM,OAAO,IAAI;AAEjD,WAAO;AAAA,MACN,GAAI,eAAe,SAAS;AAAA,MAG5B,GAAI;AAAA,IACL;AAAA,EACD;AAEA,SAAO;AAAA,IACN,OAAO;AAAA,IACP;AAAA,IACA;AAAA,EACD;AACD;","names":[]}
@@ -1,19 +0,0 @@
1
- // src/transforms/defaultValuesConfig.ts
2
- var defaultValuesConfig = (_schema, config) => {
3
- const verify = async (tableName, data) => {
4
- const resolvedConfig = typeof config === "function" ? await config() : config;
5
- return {
6
- ...resolvedConfig[tableName],
7
- ...data
8
- };
9
- };
10
- return {
11
- _type: "defaultValues",
12
- verify,
13
- config
14
- };
15
- };
16
- export {
17
- defaultValuesConfig
18
- };
19
- //# sourceMappingURL=index.mjs.map
@@ -1 +0,0 @@
1
- {"version":3,"sources":["../../src/transforms/defaultValuesConfig.ts"],"sourcesContent":["import {\n\tDataModelFromSchemaDefinition,\n\tDocumentByName,\n\tGenericSchema,\n\tSchemaDefinition,\n\tTableNamesInDataModel,\n\tWithoutSystemFields,\n} from \"convex/server\";\n\nimport { DefaultValuesConfigData, MakeOptional } from \"../core/types\";\n\n/**\n * Creates a default values transform.\n *\n * Makes specified fields optional in insert() by providing default values.\n * Supports both static config objects and dynamic functions (sync or async).\n *\n * @param schema - Your Convex schema definition\n * @param config - Default values config (object or function returning object)\n * @returns Config object for use with verifyConfig\n *\n * @example\n * ```ts\n * // Static config (same values reused)\n * const defaults = defaultValuesConfig(schema, {\n * posts: { status: 'draft', views: 0 },\n * });\n *\n * // Dynamic config (fresh values on each insert)\n * const defaults = defaultValuesConfig(schema, () => ({\n * posts: { status: 'draft', slug: generateRandomSlug() },\n * }));\n *\n * // Async config\n * const defaults = defaultValuesConfig(schema, async () => ({\n * posts: { category: await fetchDefaultCategory() },\n * }));\n * ```\n */\nexport const defaultValuesConfig = <\n\tS extends SchemaDefinition<GenericSchema, boolean>,\n\tDataModel extends DataModelFromSchemaDefinition<S>,\n\tconst C extends DefaultValuesConfigData<DataModel>,\n>(\n\t_schema: S,\n\tconfig: C | (() => C | Promise<C>),\n) => {\n\t/**\n\t * Apply default values to the data for a given table.\n\t * Async to support dynamic config functions.\n\t */\n\tconst verify = async <TN extends TableNamesInDataModel<DataModel>>(\n\t\ttableName: TN,\n\t\tdata: MakeOptional<\n\t\t\tWithoutSystemFields<DocumentByName<DataModel, TN>>,\n\t\t\tkeyof C[TN]\n\t\t>,\n\t): Promise<WithoutSystemFields<DocumentByName<DataModel, TN>>> => {\n\t\t// Resolve config - handle both direct object and function forms\n\t\tconst resolvedConfig =\n\t\t\ttypeof config === \"function\" ? await config() : config;\n\n\t\treturn {\n\t\t\t...(resolvedConfig[tableName] as Partial<\n\t\t\t\tWithoutSystemFields<DocumentByName<DataModel, TN>>\n\t\t\t>),\n\t\t\t...(data as WithoutSystemFields<DocumentByName<DataModel, TN>>),\n\t\t};\n\t};\n\n\treturn {\n\t\t_type: \"defaultValues\" as const,\n\t\tverify,\n\t\tconfig,\n\t};\n};\n"],"mappings":";AAuCO,IAAM,sBAAsB,CAKlC,SACA,WACI;AAKJ,QAAM,SAAS,OACd,WACA,SAIiE;AAEjE,UAAM,iBACL,OAAO,WAAW,aAAa,MAAM,OAAO,IAAI;AAEjD,WAAO;AAAA,MACN,GAAI,eAAe,SAAS;AAAA,MAG5B,GAAI;AAAA,IACL;AAAA,EACD;AAEA,SAAO;AAAA,IACN,OAAO;AAAA,IACP;AAAA,IACA;AAAA,EACD;AACD;","names":[]}